HtmlTextWriter.AddStyleAttribute Méthode

Définition

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.

Surcharges

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.

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.

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.

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.

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)

Paramètres

name
String

Chaîne contenant l'attribut de style à ajouter.

value
String

Chaîne qui contient la valeur à assigner à l'attribut.

Exemples

L’exemple de code suivant montre comment utiliser la RenderBeginTag surcharge de la AddStyleAttribute(String, String) méthode pour afficher font-size et color styler des attributs sur un <p> élément. Cet exemple de code utilise la HtmlTextWriter classe pour afficher le contenu du contrôle.

// 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()

Remarques

Utilisez la AddStyleAttribute surcharge de la AddStyleAttribute(String, String) méthode lorsque le style n’est pas membre de l’énumération HtmlTextWriterStyle ou n’est pas connu avant l’exécution.

La HtmlTextWriter classe conserve une liste de styles pour les éléments de balisage qu’elle affiche. Lorsque la RenderBeginTag méthode est appelée, tous les styles ajoutés par la AddStyleAttribute méthode sont rendus à la balise d’ouverture de l’élément. La liste des styles est ensuite effacée.

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

  • Utilisez la AddStyleAttribute méthode pour ajouter des attributs de style à 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 à

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.

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)

Paramètres

key
HtmlTextWriterStyle

HtmlTextWriterStyle représentant l'attribut de style à ajouter au flux de sortie.

value
String

Chaîne qui contient la valeur à assigner à l'attribut.

Exemples

L’exemple de code suivant montre comment utiliser une partie d’un remplacement de la RenderBeginTag méthode dans une classe dérivée de la HtmlTextWriter classe . Le code vérifie si un <Label> élément est affiché. Si c’est le cas, la IsStyleAttributeDefined méthode est appelée pour vérifier si un Color attribut de style a été défini pour l’élément <Label> . Si aucun Color attribut n’a été défini, le code appelle cette surcharge de la AddStyleAttribute méthode pour ajouter l’attribut Color à l’attribut de style, puis définissez sa valeur sur 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

Remarques

Utilisez la AddStyleAttribute surcharge de la AddStyleAttribute(HtmlTextWriterStyle, String) méthode lorsque le style est membre de l’énumération HtmlTextWriterStyle et est connu avant l’exécution.

La HtmlTextWriter classe conserve une liste de styles pour les éléments de balisage qu’elle affiche. Lorsque la RenderBeginTag méthode est appelée, tous les styles ajoutés par la AddStyleAttribute méthode sont rendus à la balise d’ouverture de l’élément. La liste des styles est ensuite effacée.

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

  • Utilisez la AddStyleAttribute méthode pour ajouter des attributs de style à 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 à

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.

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)

Paramètres

name
String

Chaîne contenant l'attribut de style à ajouter.

value
String

Chaîne qui contient la valeur à assigner à l'attribut.

key
HtmlTextWriterStyle

Valeur HtmlTextWriterStyle qui représente l'attribut de style à ajouter.

Remarques

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

Voir aussi

S’applique à