HtmlTextWriter.AddAttribute Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

S’applique à

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.

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

S’applique à

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.

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

S’applique à

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

S’applique à

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

S’applique à

Partager via

HtmlTextWriter.AddAttribute Méthode

Définition

Surcharges

AddAttribute(String, String)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

AddAttribute(HtmlTextWriterAttribute, String)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

AddAttribute(String, String, Boolean)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

AddAttribute(String, String, HtmlTextWriterAttribute)

Paramètres

Remarques

Voir aussi

S’applique à

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Paramètres

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires