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.Writes any tab spacing and the opening tag of the specified markup element to the output stream.

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.The markup element of which to write the opening tag.

Exemples

L’exemple de code suivant illustre le <img> rendu d’un élément dans lequel les deux surcharges de la WriteAttribute méthode sont appelées.The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. L’exemple de code utilise le processus suivant :The code example uses the following process:

  • Appelle la WriteBeginTag méthode, qui restitue les caractères d’ouverture de l’élément.Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Appelle la WriteAttribute(String, String) surcharge, qui écrit un alt attribut et sa valeur dans l' <img> élément.Calls the WriteAttribute(String, String) overload, which writes an alt attribute and its value to the <img> element.

  • Appelle la WriteAttribute(String, String, Boolean) surcharge pour restituer un myattribute attribut personnalisé No "encoding" required, avec la valeur, puis affecte fEncode à falsela valeur.Calls the WriteAttribute(String, String, Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Ferme la balise d’ouverture de l’élément, puis appelle WriteEndTag la méthode pour fermer <img> l’élément.Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

Cet exemple de code génère le balisage suivant :This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Remarques

La WriteBeginTag méthode n’écrit pas le Chevron fermant (>) de la balise d’ouverture de l’élément de balisage.The WriteBeginTag method does not write the closing angle bracket (>) of the markup element's opening tag. Cela permet d’écrire des attributs de balisage dans la balise d’ouverture de l’élément.This allows the writing of markup attributes to the opening tag of the element. Utilisez la TagRightChar constante pour fermer la balise d’ouverture lors WriteBeginTag de l’appel de la méthode.Use the TagRightChar constant to close the opening tag when calling the WriteBeginTag method. Utilisez la WriteBeginTag méthode avec la SelfClosingTagEnd constante lorsque vous écrivez des éléments de balisage qui se ferment automatiquement.Use the WriteBeginTag method with the SelfClosingTagEnd constant when you write markup elements that are self-closing.

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 restituent des éléments de balisage de la même façon pour chaque requête.The WriteBeginTag method is used by custom server controls that do not allow tag or attribute mapping and render markup elements in the same way for each request.

S’applique à

Voir aussi