Partager via


HtmlTextWriter.WriteBeginTag(String) Méthode

Définition

Écrit tout espacement de tabulation et la balise d'ouverture de l'élément de balisage spécifié dans le flux de sortie.

public:
 virtual void WriteBeginTag(System::String ^ tagName);
public virtual void WriteBeginTag (string tagName);
abstract member WriteBeginTag : string -> unit
override this.WriteBeginTag : string -> unit
Public Overridable Sub WriteBeginTag (tagName As String)

Paramètres

tagName
String

Élément de balisage dont il faut écrire la balise d'ouverture.

Exemples

L’exemple de code suivant illustre le rendu d’un <img> élément dans lequel les deux surcharges de la WriteAttribute méthode sont appelées. L’exemple de code utilise le processus suivant :

  • Appelle la WriteBeginTag méthode, qui restitue les caractères d’ouverture de l’élément.

  • Appelle la WriteAttribute(String, String) surcharge, qui écrit un alt attribut et sa valeur dans l’élément <img> .

  • Appelle la WriteAttribute(String, String, Boolean) surcharge pour afficher un attribut personnalisé myattribute , avec la valeur , No "encoding" requiredpuis définit sur fEncodefalse.

  • Ferme la balise d’ouverture de l’élément, puis appelle la WriteEndTag méthode pour fermer l’élément <img> .

Cet exemple de code génère le balisage suivant :

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );
// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");
' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Remarques

La WriteBeginTag méthode n’écrit pas le crochet fermant (>) de la balise ouvrante de l’élément de balisage. Cela permet d’écrire des attributs de balisage dans la balise d’ouverture de l’élément. Utilisez la TagRightChar constante pour fermer la balise d’ouverture lors de l’appel de la WriteBeginTag méthode. Utilisez la WriteBeginTag méthode avec la SelfClosingTagEnd constante lorsque vous écrivez des éléments de balisage qui se ferment automatiquement.

La WriteBeginTag méthode est utilisée par les contrôles serveur personnalisés qui n’autorisent pas le mappage de balises ou d’attributs et qui affichent les éléments de balisage de la même manière pour chaque requête.

S’applique à

Voir aussi