HtmlTextWriter.AddAttribute Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.

Surcharges

AddAttribute(String, String)	Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.
AddAttribute(HtmlTextWriterAttribute, String)	Ajoute l'attribut de balisage et la valeur de l'attribut à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.
AddAttribute(String, String, Boolean)	Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.
AddAttribute(String, String, HtmlTextWriterAttribute)	Ajoute l'attribut et la valeur de balisage spécifiés, ainsi qu'une valeur d'énumération HtmlTextWriterAttribute, à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Ajoute l'attribut de balisage et la valeur de l'attribut à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.

AddAttribute(String, String)

Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute (string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Paramètres

name

String

Chaîne qui contient le nom de l'attribut à ajouter.

value

String

Chaîne contenant la valeur à assigner à l'attribut.

Exemples

L’exemple de code suivant montre comment appeler la AddAttribute méthode avant d’appeler la RenderBeginTag méthode. Le code appelle deux surcharges différentes de AddAttribute et deux surcharges différentes de avant d’appeler AddStyleAttribute la RenderBeginTag méthode pour afficher un <span> élément dans le flux de sortie. La AddAttribute(String, String) méthode est utilisée pour définir l’attribut personnalisé nommé CustomAttribute et la valeur personnalisée nommée CustomAttributeValue pour l’élément <span> rendu par ce code.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;

' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(String, String) méthode si l’attribut n’est pas l’une HtmlTextWriterAttribute des valeurs ou si l’attribut n’est connu qu’au moment de l’exécution.

Pour une instance d’un élément de balisage donné, la HtmlTextWriter classe conserve une liste d’attributs pour cet élément. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par la AddAttribute méthode sont rendus à la balise d’ouverture de l’élément. La liste des attributs est ensuite effacée de l’objet HtmlTextWriter .

Le modèle de codage pour les éléments de balisage de rendu est le suivant :

• Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément .

• Utiliser la méthode RenderBeginTag.

• Utilisez d’autres méthodes si nécessaire pour restituer le contenu trouvé entre les balises d’ouverture et de fermeture de l’élément.

• Utiliser la méthode RenderEndTag.

Voir aussi

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

AddAttribute(HtmlTextWriterAttribute, String)

Ajoute l'attribut de balisage et la valeur de l'attribut à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Paramètres

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute représentant l'attribut de balisage à ajouter au flux de sortie.

value

String

Chaîne contenant la valeur à assigner à l'attribut.

Exemples

L’exemple de code suivant montre comment utiliser la AddAttribute surcharge de la AddAttribute(HtmlTextWriterAttribute, String) méthode pour ajouter un Onclick attribut à un élément de balisage, puis définir sa valeur sur le code ECMAScript suivant :

alert('Hello');  

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(HtmlTextWriterAttribute, String) méthode pour afficher un attribut de balisage standard.

Pour une instance d’un élément de balisage donné, la HtmlTextWriter classe conserve une liste d’attributs pour cet élément. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par la AddAttribute méthode sont rendus à la balise d’ouverture de l’élément. La liste des attributs est ensuite effacée de .HtmlTextWriter

Le modèle de codage pour les éléments de balisage de rendu est le suivant :

• Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément .

• Utiliser la méthode RenderBeginTag.

• Utilisez d’autres méthodes si nécessaire pour restituer le contenu trouvé entre les balises d’ouverture et de fermeture de l’élément.

• Utiliser la méthode RenderEndTag.

Voir aussi

• TextWriter
• RenderBeginTag
• RenderEndTag()

AddAttribute(String, String, Boolean)

Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute (string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Paramètres

name

String

Chaîne qui contient le nom de l'attribut à ajouter.

value

String

Chaîne contenant la valeur à assigner à l'attribut.

fEndode

Boolean

true pour encoder l'attribut et sa valeur ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser la AddAttribute surcharge de la AddAttribute(String, String, Boolean) méthode pour s’assurer qu’un attribut personnalisé, nommé myattribute, et sa valeur ne sont pas encodés pour un <img> élément.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(String, String, Boolean) méthode si l’attribut n’est pas l’une des valeurs ou si l’attribut HtmlTextWriterAttribute n’est pas connu tant que l’exécution et l’encodage ne sont pas nécessaires.

Pour une instance d’un élément de balisage donné, la HtmlTextWriter classe conserve une liste d’attributs pour cet élément. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par la AddAttribute méthode sont rendus à la balise d’ouverture de l’élément. La liste des attributs est ensuite effacée de l’objet HtmlTextWriter .

Utilisez la AddAttribute(String, String, Boolean) méthode avec fEncode la valeur true, si l’attribut peut éventuellement contenir un guillemet (« ), un signe inférieur à (<) ou un esperluette (&). L’appel de méthode encodera l’attribut pour répondre aux exigences de l’appareil demandeur. Vous pouvez définir fEncode sur false, si vous savez qu’aucun de ces caractères ne sera généré ou si vous savez que l’attribut est déjà encodé.

Si le type d’attribut est Style, la valeur n’est pas encodée même si fEndode est true. Vérifiez que la valeur de style est conforme à CSS et qu’elle ne contient pas de code malveillant.

Le modèle de codage pour les éléments de balisage de rendu est le suivant :

• Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément .

• Utiliser la méthode RenderBeginTag.

• Utilisez d’autres méthodes si nécessaire pour restituer le contenu trouvé entre les balises d’ouverture et de fermeture de l’élément.

• Utiliser la méthode RenderEndTag.

Voir aussi

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

AddAttribute(String, String, HtmlTextWriterAttribute)

Ajoute l'attribut et la valeur de balisage spécifiés, ainsi qu'une valeur d'énumération HtmlTextWriterAttribute, à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Paramètres

name

String

Chaîne qui contient le nom de l'attribut à ajouter.

value

String

Chaîne contenant la valeur à assigner à l'attribut.

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute qui représente l'attribut.

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(String, String, HtmlTextWriterAttribute) méthode uniquement lors de l’héritage de la HtmlTextWriter classe . Il vous permet de créer name des paires et key pour les attributs.

Voir aussi

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Ajoute l'attribut de balisage et la valeur de l'attribut à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Paramètres

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute représentant l'attribut de balisage à ajouter au flux de sortie.

value

String

Chaîne contenant la valeur à assigner à l'attribut.

fEncode

Boolean

true pour encoder l'attribut et sa valeur ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser la AddAttribute(HtmlTextWriterAttribute, String, Boolean) méthode pour s’assurer que la valeur de chaîne affectée à un Alt attribut pour un <img> élément est encodée pour l’appareil demandeur.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();

// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();

' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(HtmlTextWriterAttribute, String, Boolean) méthode pour afficher un attribut de balisage standard, avec un encodage facultatif.

Pour une instance d’un élément de balisage donné, la HtmlTextWriter classe conserve une liste d’attributs pour cet élément. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par sont AddAttribute rendus à la balise d’ouverture de l’élément. La liste des attributs est ensuite effacée de l’objet HtmlTextWriter .

Utilisez la AddAttribute(HtmlTextWriterAttribute, String, Boolean) méthode avec fEncode la valeur true, si l’attribut peut éventuellement contenir un guillemet (« ), un signe inférieur à (<) ou un esperluette (&). L’appel de méthode encodera l’attribut pour répondre aux exigences de l’appareil demandeur. Vous pouvez définir fEncode sur false, si vous savez qu’aucun de ces caractères ne sera généré ou si vous savez que l’attribut est déjà encodé.

Si le type d’attribut est Style, la valeur n’est pas encodée même si fEncode est true. Vérifiez que la valeur de style est conforme à CSS et qu’elle ne contient pas de code malveillant.

Le modèle de codage pour les éléments de balisage de rendu est le suivant :

• Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément .

• Utiliser la méthode RenderBeginTag.

• Utilisez d’autres méthodes si nécessaire pour restituer le contenu trouvé entre les balises d’ouverture et de fermeture de l’élément.

• Utiliser la méthode RenderEndTag.

Voir aussi

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)