HtmlTextWriter.WriteAttribute Méthode

Définition

Écrit un attribut de balisage et sa valeur dans le flux de sortie.

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.

WriteAttribute(String, String)

Écrit l'attribut de balisage spécifié et sa valeur dans le flux de sortie.

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.

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.

value
String

Valeur à affecter à l’attribut.

fEncode
Boolean

true pour encoder l’attribut et sa valeur affectée ; sinon, false.

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

Utilisez la WriteAttribute méthode pour écrire des attributs de balisage et leurs valeurs avec ou sans encodage. La WriteAttribute méthode utilise la HtmlAttributeEncode méthode pour effectuer l’encodage.

La WriteAttribute méthode écrit la valeur de l’attribut entre guillemets doubles (« ). Si value a la valeur null, la WriteAttribute méthode écrit uniquement le nom de l’attribut.

Notes pour les héritiers

Dans les classes dérivées, vous pouvez remplacer la WriteAttribute(String, String, Boolean) méthode pour définir des règles personnalisées pour écrire des attributs et leurs valeurs. Par exemple, vous pouvez écrire du code qui a permis à la WriteAttribute(String, String, Boolean) méthode d’écrire un attribut avec une valeur vide.

Voir aussi

S’applique à

WriteAttribute(String, String)

Écrit l'attribut de balisage spécifié et sa valeur dans le flux de sortie.

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.

value
String

Valeur à affecter à l’attribut.

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

Utilisez la WriteAttribute méthode pour écrire des attributs de balisage et leurs valeurs sans encodage. La WriteAttribute méthode écrit la valeur de l’attribut entre guillemets doubles (« ). Si value a la valeur null, la WriteAttribute méthode écrit uniquement le nom de l’attribut.

Notes pour les héritiers

Dans les classes dérivées, vous pouvez remplacer la WriteAttribute(String, String) méthode pour définir des règles personnalisées pour écrire des attributs et leurs valeurs. Par exemple, vous pouvez écrire du code qui a permis à la WriteAttribute(String, String) méthode d’écrire un attribut avec une valeur vide.

Voir aussi

S’applique à