HtmlTextWriter.AddAttribute Méthode

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éé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.

Surcharges

Nom	Description
AddAttribute(String, String)	Ajoute l’attribut et la valeur de balisage spécifiés à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.
AddAttribute(HtmlTextWriterAttribute, String)	Ajoute l’attribut de balisage et la valeur d’attribut à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.
AddAttribute(String, String, Boolean)	Ajoute l’attribut et la valeur de balisage spécifiés à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode, 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éé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Ajoute l’attribut de balisage et la valeur d’attribut à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode, 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éé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.

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 contenant le nom de l’attribut à ajouter.

value: String

Chaîne contenant la valeur à affecter à 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 et AddAttribute deux surcharges différentes avant AddStyleAttribute d’appeler la RenderBeginTag méthode pour restituer un <span> élément au 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 des valeurs, ou si l’attribut n’est pas connu jusqu’au moment de HtmlTextWriterAttribute 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 le rendu des éléments de balisage 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 afficher 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 d’attribut à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.

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

Qui HtmlTextWriterAttribute représente l’attribut de balisage à ajouter au flux de sortie.

value: String

Chaîne contenant la valeur à affecter à 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 le rendu des éléments de balisage 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 afficher 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éé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode, 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 contenant le nom de l’attribut à ajouter.

value: String

Chaîne contenant la valeur à affecter à 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 vous assurer qu’un attribut personnalisé, nommé myattributeet 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 HtmlTextWriterAttribute valeurs, ou si l’attribut n’est pas connu tant que l’exécution et l’encodage n’est pas nécessaire.

Utilisez la AddAttribute(String, String, Boolean) méthode avec fEncode la valeur définie true, si l’attribut peut éventuellement contenir un guillemet ("), un signe inférieur à (<) ou un ampersand (&). L’appel de méthode encodera l’attribut pour répondre aux exigences de l’appareil demandeur. Vous pouvez définir fEncodefalsesur , 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 elle fEndode est true. Vérifiez que la valeur de style est conforme à CSS et ne contient pas de code malveillant.

Le modèle de codage pour le rendu des éléments de balisage 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 afficher 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éé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode.

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 contenant le nom de l’attribut à ajouter.

value: String

Chaîne contenant la valeur à affecter à l’attribut.

key: HtmlTextWriterAttribute

Qui HtmlTextWriterAttribute 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 de nouvelles name paires key pour les attributs.

Voir aussi

S’applique à

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Ajoute l’attribut de balisage et la valeur d’attribut à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la RenderBeginTag méthode, 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

Qui HtmlTextWriterAttribute représente l’attribut de balisage à ajouter au flux de sortie.

value: String

Chaîne contenant la valeur à affecter à 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 vous assurer que la valeur de chaîne affectée à un attribut pour un Alt<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 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 celui-ci AddAttribute 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(HtmlTextWriterAttribute, String, Boolean) méthode avec fEncode la valeur définie true, si l’attribut peut éventuellement contenir un guillemet ("), un signe inférieur à (<) ou un ampersand (&). L’appel de méthode encodera l’attribut pour répondre aux exigences de l’appareil demandeur. Vous pouvez définir fEncodefalsesur , 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 elle fEncode est true. Vérifiez que la valeur de style est conforme à CSS et ne contient pas de code malveillant.

Le modèle de codage pour le rendu des éléments de balisage 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 afficher le contenu trouvé entre les balises d’ouverture et de fermeture de l’élément.
Utiliser la méthode RenderEndTag.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?