HtmlTextWriter.WriteAttribute Méthode

Définition

Écrit un attribut de balisage et sa valeur dans le flux de sortie.Writes a markup attribute and its value to the output stream.

Surcharges

WriteAttribute(String, String, Boolean)

Écrit l’attribut de balisage et la valeur spécifiés dans le flux de sortie et, si elle est spécifiée, écrit la valeur encodée.Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

WriteAttribute(String, String)

Écrit l'attribut de balisage spécifié et sa valeur dans le flux de sortie.Writes the specified markup attribute and value to the output stream.

WriteAttribute(String, String, Boolean)

Écrit l’attribut de balisage et la valeur spécifiés dans le flux de sortie et, si elle est spécifiée, écrit la valeur encodée.Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);
public virtual void WriteAttribute (string name, string value, bool fEncode);
abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit
Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

Paramètres

name
String

Attribut de balisage à écrire dans le flux de sortie.The markup attribute to write to the output stream.

value
String

Valeur à affecter à l’attribut.The value assigned to the attribute.

fEncode
Boolean

true pour encoder l’attribut et sa valeur affectée ; sinon, false.true to encode the attribute and its assigned value; otherwise, false.

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

Utilisez la WriteAttribute méthode pour écrire des attributs de balisage et leurs valeurs avec ou sans encodage.Use the WriteAttribute method to write markup attributes and their values with or without encoding. La WriteAttribute méthode utilise la HtmlAttributeEncode méthode pour effectuer l’encodage.The WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

La WriteAttribute méthode écrit la valeur d’attribut placée entre guillemets doubles (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Si value est null, laWriteAttribute méthode écrit uniquement le nom de l’attribut.If value is null, the WriteAttribute method writes only the attribute name.

Notes pour les héritiers

Dans les classes dérivées, vous pouvez substituer la WriteAttribute(String, String, Boolean) méthode pour définir des règles personnalisées pour l’écriture d’attributs et de leurs valeurs.In derived classes, you can override the WriteAttribute(String, String, Boolean) method to define custom rules for writing attributes and their values. Par exemple, vous pouvez écrire du code qui permettait à la WriteAttribute(String, String, Boolean) méthode d’écrire un attribut avec une valeur vide.For example, you could write code that allowed the WriteAttribute(String, String, Boolean) method to write an attribute with an empty value.

Voir aussi

WriteAttribute(String, String)

Écrit l'attribut de balisage spécifié et sa valeur dans le flux de sortie.Writes the specified markup attribute and value to the output stream.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);
public virtual void WriteAttribute (string name, string value);
abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit
Public Overridable Sub WriteAttribute (name As String, value As String)

Paramètres

name
String

Attribut à écrire dans le flux de sortie.The attribute to write to the output stream.

value
String

Valeur à affecter à l’attribut.The value assigned to the attribute.

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

Utilisez la WriteAttribute méthode pour écrire des attributs de balisage et leurs valeurs sans encodage.Use the WriteAttribute method to write markup attributes and their values with no encoding. La WriteAttribute méthode écrit la valeur d’attribut placée entre guillemets doubles (").The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). Si value est null, laWriteAttribute méthode écrit uniquement le nom de l’attribut.If value is null, the WriteAttribute method writes only the attribute name.

Notes pour les héritiers

Dans les classes dérivées, vous pouvez substituer la WriteAttribute(String, String) méthode pour définir des règles personnalisées pour l’écriture d’attributs et de leurs valeurs.In derived classes, you can override the WriteAttribute(String, String) method to define custom rules for writing attributes and their values. Par exemple, vous pouvez écrire du code qui permettait à la WriteAttribute(String, String) méthode d’écrire un attribut avec une valeur vide.For example, you could write code that allowed the WriteAttribute(String, String) method to write an attribute with an empty value.

Voir aussi

S’applique à