HtmlTextWriter.AddStyleAttribute Method

Definition

Ajoute un attribut de style de balisage à 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 a markup style attribute to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

Overloads

AddStyleAttribute(String, String)

Ajoute l'attribut de style de balisage spécifié et la valeur de l'attribut à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.Adds the specified markup style attribute and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(HtmlTextWriterStyle, String)

Ajoute l'attribut de style de balisage associé à la valeur HtmlTextWriterStyle spécifiée et la valeur de l'attribut à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.Adds the markup style attribute associated with the specified HtmlTextWriterStyle value and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(String, String, HtmlTextWriterStyle)

Ajoute l'attribut de style de balisage spécifié et la valeur d'attribut, avec une valeur d'énumération HtmlTextWriterStyle, à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.Adds the specified markup style attribute and the attribute value, along with an HtmlTextWriterStyle enumeration value, to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(String, String)

Ajoute l'attribut de style de balisage spécifié et la valeur de l'attribut à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.Adds the specified markup style attribute and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

public:
 virtual void AddStyleAttribute(System::String ^ name, System::String ^ value);
public virtual void AddStyleAttribute (string name, string value);
abstract member AddStyleAttribute : string * string -> unit
override this.AddStyleAttribute : string * string -> unit
Public Overridable Sub AddStyleAttribute (name As String, value As String)

Parameters

name
String

Chaîne contenant l'attribut de style à ajouter.A string that contains the style attribute to add.

value
String

Chaîne qui contient la valeur à assigner à l'attribut.A string that contains the value to assign to the attribute.

Examples

L’exemple de code suivant montre comment utiliser la surcharge RenderBeginTag de la méthode AddStyleAttribute(String, String) pour restituer les attributs de style font-size et color sur un élément <p>.The following code example shows how to use the RenderBeginTag overload of the AddStyleAttribute(String, String) method to render font-size and color style attributes on a <p> element. Cet exemple de code utilise la classe HtmlTextWriter pour afficher le contenu du contrôle.This code example uses the HtmlTextWriter class to render the contents of the control.

// Add style attribute for 'p'(paragraph) element.
writer->AddStyleAttribute( "font-size", "12pt" );
writer->AddStyleAttribute( "color", "fuchsia" );
// Output the 'p' (paragraph) element with the style attributes.
writer->RenderBeginTag( "p" );
// Output the 'Message' property contents and the time on the server.
writer->Write( String::Concat( Message, "<br>",
   "The time on the server: ",
   System::DateTime::Now.ToLongTimeString() ) );

// Close the element.
writer->RenderEndTag();
// Add style attribute for 'p'(paragraph) element.
writer.AddStyleAttribute("font-size", "12pt");
writer.AddStyleAttribute("color", "fuchsia");
// Output the 'p' (paragraph) element with the style attributes.
writer.RenderBeginTag("p");
// Output the 'Message' property contents and the time on the server.
writer.Write(Message + "<br>" +
    "The time on the server: " +
    System.DateTime.Now.ToLongTimeString());

// Close the element.
writer.RenderEndTag();
'Add style attribute for 'p'(paragraph) element.
writer.AddStyleAttribute("font-size", "12pt")
writer.AddStyleAttribute("color", "fuchsia")

'Output the 'p' (paragraph) element with the style attributes.
writer.RenderBeginTag("p")

'Output the 'Message' property contents and the time on the server.
writer.Write((Message & "<br>" & "The time on the server: " & _
   System.DateTime.Now.ToLongTimeString()))

' Close the element.
writer.RenderEndTag()

Remarks

Utilisez la surcharge AddStyleAttribute de la méthode AddStyleAttribute(String, String) lorsque le style n’est pas un membre de l’énumération HtmlTextWriterStyle ou qu’il n’est pas connu jusqu’au moment de l’exécution.Use the AddStyleAttribute overload of the AddStyleAttribute(String, String) method when the style is not a member of the HtmlTextWriterStyle enumeration or is not known until run time.

La classe HtmlTextWriter gère une liste de styles pour les éléments de balisage qu’elle restitue.The HtmlTextWriter class maintains a list of styles for the markup elements it renders. Lorsque la méthode RenderBeginTag est appelée, tous les styles ajoutés par la méthode AddStyleAttribute sont rendus dans la balise d’ouverture de l’élément.When the RenderBeginTag method is called, any styles that are added by the AddStyleAttribute method are rendered to the opening tag of the element. La liste des styles est alors effacée.The list of styles is then cleared.

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 méthode AddStyleAttribute pour ajouter des attributs de style à l’élément.Use the AddStyleAttribute method to add any style 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 opening and closing tags.

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

See also

AddStyleAttribute(HtmlTextWriterStyle, String)

Ajoute l'attribut de style de balisage associé à la valeur HtmlTextWriterStyle spécifiée et la valeur de l'attribut à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.Adds the markup style attribute associated with the specified HtmlTextWriterStyle value and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

public:
 virtual void AddStyleAttribute(System::Web::UI::HtmlTextWriterStyle key, System::String ^ value);
public virtual void AddStyleAttribute (System.Web.UI.HtmlTextWriterStyle key, string value);
abstract member AddStyleAttribute : System.Web.UI.HtmlTextWriterStyle * string -> unit
override this.AddStyleAttribute : System.Web.UI.HtmlTextWriterStyle * string -> unit
Public Overridable Sub AddStyleAttribute (key As HtmlTextWriterStyle, value As String)

Parameters

key
HtmlTextWriterStyle

HtmlTextWriterStyle représentant l'attribut de style à ajouter au flux de sortie.An HtmlTextWriterStyle that represents the style attribute to add to the output stream.

value
String

Chaîne qui contient la valeur à assigner à l'attribut.A string that contains the value to assign to the attribute.

Examples

L’exemple de code suivant montre comment utiliser une partie d’une substitution de la méthode RenderBeginTag dans une classe dérivée de la classe HtmlTextWriter.The following code example demonstrates how to use part of an override of the RenderBeginTag method in a class derived from the HtmlTextWriter class. Le code vérifie si un élément <Label> est affiché.The code checks whether a <Label> element is being rendered. Si c’est le cas, la méthode IsStyleAttributeDefined est appelée pour vérifier si un attribut de style Color a été défini pour l’élément <Label>.If so, the IsStyleAttributeDefined method is called to check whether a Color style attribute has been defined for the <Label> element. Si un attribut Color n’a pas été défini, le code appelle cette surcharge de la méthode AddStyleAttribute pour ajouter l’attribut Color à l’attribut style, puis affecte la valeur redà la valeur.If a Color attribute has not been defined, the code calls this overload of the AddStyleAttribute method to add the Color attribute to the style attribute, and then set its value to red.

// If the markup element being rendered is a Label,
// render the opening tag of a <Font> element before it.
if ( tagKey == HtmlTextWriterTag::Label )
{
   
   // Check whether a Color style attribute is
   // included on the Label. If not, use the
   // AddStyleAttribute and GetStyleName methods to add one
   // and set its value to red.
   if (  !IsStyleAttributeDefined( HtmlTextWriterStyle::Color ) )
   {
      AddStyleAttribute( GetStyleName( HtmlTextWriterStyle::Color ), "red" );
   }

// If the markup element being rendered is a Label,
// render the opening tag of a Font element before it.
if (tagKey == HtmlTextWriterTag.Label)
{
    // Check whether a Color style attribute is 
    // included on the Label. If not, use the
    // AddStyleAttribute and GetStyleName methods to add one
    // and set its value to red.
    if (!IsStyleAttributeDefined(HtmlTextWriterStyle.Color))
    {
        AddStyleAttribute(GetStyleName(HtmlTextWriterStyle.Color), "red");
    }
' If the markup element being rendered is a Label,
' render the opening tag of a Font element before it.
If tagKey = HtmlTextWriterTag.Label Then
    ' Check whether a Color style attribute is 
    ' included on the Label. If not, use the
    ' AddStyleAttribute and GetStyleName methods to add one
    ' and set its value to red.
    If Not IsStyleAttributeDefined(HtmlTextWriterStyle.Color) Then
        AddStyleAttribute(GetStyleName(HtmlTextWriterStyle.Color), "red")
    End If

Remarks

Utilisez la surcharge AddStyleAttribute de la méthode AddStyleAttribute(HtmlTextWriterStyle, String) quand le style est membre de l’énumération HtmlTextWriterStyle et est connu avant l’exécution.Use the AddStyleAttribute overload of the AddStyleAttribute(HtmlTextWriterStyle, String) method when the style is a member of the HtmlTextWriterStyle enumeration and is known before run time.

La classe HtmlTextWriter gère une liste de styles pour les éléments de balisage qu’elle restitue.The HtmlTextWriter class maintains a list of styles for the markup elements it renders. Lorsque la méthode RenderBeginTag est appelée, tous les styles ajoutés par la méthode AddStyleAttribute sont rendus dans la balise d’ouverture de l’élément.When the RenderBeginTag method is called, any styles added by the AddStyleAttribute method are rendered to the opening tag of the element. La liste des styles est alors effacée.The list of styles is then cleared.

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 méthode AddStyleAttribute pour ajouter des attributs de style à l’élément.Use the AddStyleAttribute method to add any style 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 opening and closing tags.

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

See also

AddStyleAttribute(String, String, HtmlTextWriterStyle)

Ajoute l'attribut de style de balisage spécifié et la valeur d'attribut, avec une valeur d'énumération HtmlTextWriterStyle, à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.Adds the specified markup style attribute and the attribute value, along with an HtmlTextWriterStyle enumeration value, to the opening markup tag created by a subsequent call to the RenderBeginTag method.

protected:
 virtual void AddStyleAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterStyle key);
protected virtual void AddStyleAttribute (string name, string value, System.Web.UI.HtmlTextWriterStyle key);
abstract member AddStyleAttribute : string * string * System.Web.UI.HtmlTextWriterStyle -> unit
override this.AddStyleAttribute : string * string * System.Web.UI.HtmlTextWriterStyle -> unit
Protected Overridable Sub AddStyleAttribute (name As String, value As String, key As HtmlTextWriterStyle)

Parameters

name
String

Chaîne contenant l'attribut de style à ajouter.A string that contains the style attribute to be added.

value
String

Chaîne qui contient la valeur à assigner à l'attribut.A string that contains the value to assign to the attribute.

key
HtmlTextWriterStyle

Valeur HtmlTextWriterStyle qui représente l'attribut de style à ajouter.An HtmlTextWriterStyle that represents the style attribute to add.

Remarks

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

See also

Applies to