HtmlTextWriter.AddAttribute Méthode

Définition

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.Adds the specified markup attribute and value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.Adds the specified markup attribute and value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.Adds the markup attribute and the attribute value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.Adds the specified markup attribute and value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method, with optional encoding.

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.Adds the specified markup attribute and value, along with an HtmlTextWriterAttribute enumeration value, to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.Adds the markup attribute and the attribute value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method, with optional encoding.

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.Adds the specified markup attribute and value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.A string containing the name of the attribute to add.

value
String

Chaîne contenant la valeur à assigner à l'attribut.A string containing the value to assign to the attribute.

Exemples

L’exemple de code suivant montre comment appeler la AddAttribute méthode avant d’appeler RenderBeginTag la méthode.The following code example demonstrates how to call the AddAttribute method before calling the RenderBeginTag method. Le code appelle deux surcharges différentes de AddAttribute et deux surcharges différentes de AddStyleAttribute avant d’appeler la RenderBeginTag méthode pour restituer <span> un élément dans le flux de sortie.The code calls two different overloads of AddAttribute and two different overloads of AddStyleAttribute before it calls the RenderBeginTag method to render a <span> element to the output stream. 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' <span> élément rendu par ce code.The AddAttribute(String, String) method is used to define the custom attribute named CustomAttribute and the custom value named CustomAttributeValue for the <span> element that this code renders.

// 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 HtmlTextWriterAttribute n’est pas l’une des valeurs, ou si l’attribut n’est pas connu jusqu’au moment de l’exécution.Use the AddAttribute overload of the AddAttribute(String, String) method if the attribute is not one of the HtmlTextWriterAttribute values, or if the attribute is not known until run time.

Pour une instance d’un élément de balisage donné HtmlTextWriter , la classe gère une liste d’attributs pour cet élément.For an instance of any given markup element, the HtmlTextWriter class maintains a list of attributes for that element. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par AddAttribute la méthode sont rendus dans la balise d’ouverture de l’élément.When the RenderBeginTag method is called, any attributes added by the AddAttribute method are rendered to the opening tag of the element. La liste des attributs est ensuite effacée de HtmlTextWriter l’objet.The list of attributes is then cleared from the HtmlTextWriter object.

Le modèle de codage pour le rendu des éléments de balisage est le suivant :The coding pattern for rendering markup elements is as follows:

  • Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément.Use the AddAttribute method to add any attributes to the element.

  • Utilisez la méthode RenderBeginTag.Use the RenderBeginTag method.

  • 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.Use other methods as needed to render the content found between the element's opening and closing tags.

  • Utilisez la méthode RenderEndTag.Use the RenderEndTag method.

Voir aussi

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.Adds the markup attribute and the attribute value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.An HtmlTextWriterAttribute that represents the markup attribute to add to the output stream.

value
String

Chaîne contenant la valeur à assigner à l'attribut.A string containing the value to assign to the attribute.

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 affecter à sa valeur le code ECMAScript suivant :The following code example shows how to use the AddAttribute overload of the AddAttribute(HtmlTextWriterAttribute, String) method to add an Onclick attribute to a markup element, and then set its value to the following ECMAScript code:

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 restituer un attribut de balisage standard.Use the AddAttribute overload of the AddAttribute(HtmlTextWriterAttribute, String) method to render a standard markup attribute.

Pour une instance d’un élément de balisage donné HtmlTextWriter , la classe gère une liste d’attributs pour cet élément.For an instance of any given markup element, the HtmlTextWriter class maintains a list of attributes for that element. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par la AddAttribute méthode sont rendus dans la balise d’ouverture de l’élément.When the RenderBeginTag method is called, any attributes that are added by the AddAttribute method are rendered to the opening tag of the element. La liste des attributs est ensuite supprimée de HtmlTextWriterla.The list of attributes is then cleared from the HtmlTextWriter.

Le modèle de codage pour le rendu des éléments de balisage est le suivant :The coding pattern for rendering markup elements is as follows:

  • Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément.Use the AddAttribute method to add any attributes to the element.

  • Utilisez la méthode RenderBeginTag.Use the RenderBeginTag method.

  • 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.Use other methods as needed to render the content found between the element's opening and closing tags.

  • Utilisez la méthode RenderEndTag.Use the RenderEndTag method.

Voir aussi

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.Adds the specified markup attribute and value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method, with optional encoding.

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.A string containing the name of the attribute to add.

value
String

Chaîne contenant la valeur à assigner à l'attribut.A string containing the value to assign to the attribute.

fEndode
Boolean

true pour encoder l'attribut et sa valeur ; sinon, false.true to encode the attribute and its value; otherwise, false.

Exemples

L’exemple de code suivant montre comment utiliser la AddAttribute surcharge de la AddAttribute(String, String, Boolean) méthode pour garantir qu’un attribut personnalisé, nommé myattributeet sa valeur, ne sont pas encodés pour <img> un élément.The following code example shows how to use the AddAttribute overload of the AddAttribute(String, String, Boolean) method to ensure that a custom attribute, named myattribute, and its value are not encoded for an <img> element.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; 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 HtmlTextWriterAttribute n’est pas l’une des valeurs, ou si l’attribut n’est pas connu jusqu’à ce que l’exécution et l’encodage soient nécessaires.Use the AddAttribute overload of the AddAttribute(String, String, Boolean) method if the attribute is not one of the HtmlTextWriterAttribute values, or if the attribute is not known until run time and encoding is needed.

Pour une instance d’un élément de balisage donné HtmlTextWriter , la classe gère une liste d’attributs pour cet élément.For an instance of any given markup element, the HtmlTextWriter class maintains a list of attributes for that element. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par AddAttribute la méthode sont rendus dans la balise d’ouverture de l’élément.When the RenderBeginTag method is called, any attributes added by the AddAttribute method are rendered to the opening tag of the element. La liste des attributs est ensuite effacée de HtmlTextWriter l’objet.The list of attributes is then cleared from the HtmlTextWriter object.

Utilisez la AddAttribute(String, String, Boolean) méthode avec fEncode la valeur true, si l’attribut peut contenir des guillemets ("), un signe inférieur à (<) ou une esperluette (&).Use the AddAttribute(String, String, Boolean) method with fEncode set to true, if the attribute can possibly contain a quotation mark ("), a less than sign (<), or an ampersand (&). L’appel de méthode encodera l’attribut pour répondre aux exigences de l’appareil demandeur.The method call will encode the attribute to meet the requirements of the requesting device. Vous pouvez affecter fEncode à falsela valeur, 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é.You can set fEncode to false, if you know that none of these characters will be generated, or if you know that the attribute is already encoded.

Si le type d’attribut Styleest, la valeur n’est pas encodée fEndode , truemême si est.If the attribute type is Style, the value won't be encoded even if fEndode is true. Assurez-vous que la valeur de style est conforme à CSS et ne contient pas de code malveillant.Ensure that the style value is CSS-compliant and doesn't contain malicious code.

Le modèle de codage pour le rendu des éléments de balisage est le suivant :The coding pattern for rendering markup elements is as follows:

  • Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément.Use the AddAttribute method to add any attributes to the element.

  • Utilisez la méthode RenderBeginTag.Use the RenderBeginTag method.

  • 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.Use other methods as needed to render the content found between the element's opening and closing tags.

  • Utilisez la méthode RenderEndTag.Use the RenderEndTag method.

Voir aussi

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.Adds the specified markup attribute and value, along with an HtmlTextWriterAttribute enumeration value, to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

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.A string containing the name of the attribute to add.

value
String

Chaîne contenant la valeur à assigner à l'attribut.A string containing the value to assign to the attribute.

key
HtmlTextWriterAttribute

HtmlTextWriterAttribute qui représente l'attribut.An HtmlTextWriterAttribute that represents the attribute.

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(String, String, HtmlTextWriterAttribute) méthode uniquement lorsque vous héritez de HtmlTextWriter la classe.Use the AddAttribute overload of the AddAttribute(String, String, HtmlTextWriterAttribute) method only when inheriting from the HtmlTextWriter class. Elle vous permet de créer name des paires et key pour les attributs.It enables you to create new name and key pairs for attributes.

Voir aussi

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.Adds the markup attribute and the attribute value to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method, with optional encoding.

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.An HtmlTextWriterAttribute that represents the markup attribute to add to the output stream.

value
String

Chaîne contenant la valeur à assigner à l'attribut.A string containing the value to assign to the attribute.

fEncode
Boolean

true pour encoder l'attribut et sa valeur ; sinon, false.true to encode the attribute and its value; otherwise, false.

Exemples

L’exemple de code suivant montre comment utiliser la AddAttribute(HtmlTextWriterAttribute, String, Boolean) méthode pour garantir que la valeur de chaîne assignée à Alt un attribut pour <img> un élément est encodée pour l’appareil demandeur.The following code example demonstrates how to use the AddAttribute(HtmlTextWriterAttribute, String, Boolean) method to ensure that the string value that is assigned to an Alt attribute for an <img> element is encoded for the requesting device.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No &quot;encoding &quot; 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 &quot;encoding &quot; 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 &quot;encoding &quot; required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Remarques

Utilisez la AddAttribute surcharge de la AddAttribute(HtmlTextWriterAttribute, String, Boolean) méthode pour restituer un attribut de balisage standard, avec un encodage facultatif.Use the AddAttribute overload of the AddAttribute(HtmlTextWriterAttribute, String, Boolean) method to render a standard markup attribute, with optional encoding.

Pour une instance d’un élément de balisage donné HtmlTextWriter , la classe gère une liste d’attributs pour cet élément.For an instance of any given markup element, the HtmlTextWriter class maintains a list of attributes for that element. Lorsque la RenderBeginTag méthode est appelée, tous les attributs ajoutés par AddAttribute le sont rendus dans la balise d’ouverture de l’élément.When the RenderBeginTag method is called, any attributes added by the AddAttribute are rendered to the opening tag of the element. La liste des attributs est ensuite effacée de HtmlTextWriter l’objet.The list of attributes is then cleared from the HtmlTextWriter object.

Utilisez la AddAttribute(HtmlTextWriterAttribute, String, Boolean) méthode avec fEncode la valeur true, si l’attribut peut contenir des guillemets ("), un signe inférieur à (<) ou une esperluette (&).Use the AddAttribute(HtmlTextWriterAttribute, String, Boolean) method with fEncode set to true, if the attribute can possibly contain a quotation mark ("), a less than sign (<), or an ampersand (&). L’appel de méthode encodera l’attribut pour répondre aux exigences de l’appareil demandeur.The method call will encode the attribute to meet the requirements of the requesting device. Vous pouvez affecter fEncode à falsela valeur, 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é.You can set fEncode to false, if you know that none of these characters will be generated, or if you know that the attribute is already encoded.

Si le type d’attribut Styleest, la valeur n’est pas encodée fEncode , truemême si est.If the attribute type is Style, the value won't be encoded even if fEncode is true. Assurez-vous que la valeur de style est conforme à CSS et ne contient pas de code malveillant.Ensure that the style value is CSS-compliant and doesn't contain malicious code.

Le modèle de codage pour le rendu des éléments de balisage est le suivant :The coding pattern for rendering markup elements is as follows:

  • Utilisez la AddAttribute méthode pour ajouter des attributs à l’élément.Use the AddAttribute method to add any attributes to the element.

  • Utilisez la méthode RenderBeginTag.Use the RenderBeginTag method.

  • 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.Use other methods as needed to render the content found between the element's opening and closing tags.

  • Utilisez la méthode RenderEndTag.Use the RenderEndTag method.

Voir aussi

S’applique à