HtmlTextWriter.AddStyleAttribute HtmlTextWriter.AddStyleAttribute HtmlTextWriter.AddStyleAttribute HtmlTextWriter.AddStyleAttribute Method

Definizione

Aggiunge un attributo di stile markup al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva del metodo 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.

Overload

AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String)

Aggiunge l'attributo di stile del markup specificato e il valore dell'attributo al tag del markup di apertura creato da una chiamata successiva del metodo 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) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String)

Aggiunge l'attributo di stile markup associato al valore HtmlTextWriterStyle specificato e il valore dell'attributo al tag del markup di apertura creato da una chiamata successiva del metodo 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) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle)

Aggiunge l'attributo di stile del markup specificato e il valore dell'attributo, oltre a un valore di enumerazione HtmlTextWriterStyle, al markup di apertura creato da una chiamata successiva del metodo 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) AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String)

Aggiunge l'attributo di stile del markup specificato e il valore dell'attributo al tag del markup di apertura creato da una chiamata successiva del metodo 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)

Parametri

name
String String String String

Stringa contenente l'attributo di stile da aggiungere.A string that contains the style attribute to add.

value
String String String String

Stringa contenente il valore da assegnare all'attributo.A string that contains the value to assign to the attribute.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato RenderBeginTag come utilizzare l' AddStyleAttribute(String, String) overload del metodo font-size per color eseguire il rendering e <p> gli attributi di stile su un elemento.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. Questo esempio di codice usa HtmlTextWriter la classe per eseguire il rendering del contenuto del controllo.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()

Commenti

Utilizzare l' AddStyleAttribute overload AddStyleAttribute(String, String) del metodo quando lo stile HtmlTextWriterStyle non è un membro dell'enumerazione o non è noto fino alla fase di esecuzione.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 HtmlTextWriter classe gestisce un elenco di stili per gli elementi di markup di cui esegue il rendering.The HtmlTextWriter class maintains a list of styles for the markup elements it renders. Quando viene RenderBeginTag chiamato il metodo, viene eseguito il rendering degli stili aggiunti AddStyleAttribute dal metodo al tag di apertura dell'elemento.When the RenderBeginTag method is called, any styles that are added by the AddStyleAttribute method are rendered to the opening tag of the element. L'elenco degli stili viene quindi cancellato.The list of styles is then cleared.

Il modello di codifica per il rendering degli elementi di markup è il seguente:The coding pattern for rendering markup elements is as follows:

  • Usare il AddStyleAttribute metodo per aggiungere eventuali attributi di stile all'elemento.Use the AddStyleAttribute method to add any style attributes to the element.

  • Usare il metodo RenderBeginTag.Use the RenderBeginTag method.

  • Usare altri metodi in base alle esigenze per eseguire il rendering del contenuto trovato tra i tag di apertura e di chiusura dell'elemento.Use other methods as needed to render the content found between the element opening and closing tags.

  • Usare il metodo RenderEndTag.Use the RenderEndTag method.

Vedi anche

AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String)

Aggiunge l'attributo di stile markup associato al valore HtmlTextWriterStyle specificato e il valore dell'attributo al tag del markup di apertura creato da una chiamata successiva del metodo 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)

Parametri

key
HtmlTextWriterStyle HtmlTextWriterStyle HtmlTextWriterStyle HtmlTextWriterStyle

Oggetto HtmlTextWriterStyle che rappresenta l'attributo di stile da aggiungere al flusso di output.An HtmlTextWriterStyle that represents the style attribute to add to the output stream.

value
String String String String

Stringa contenente il valore da assegnare all'attributo.A string that contains the value to assign to the attribute.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare una parte di RenderBeginTag un override del metodo in una classe HtmlTextWriter derivata dalla classe.The following code example demonstrates how to use part of an override of the RenderBeginTag method in a class derived from the HtmlTextWriter class. Il codice controlla se viene <Label> eseguito il rendering di un elemento.The code checks whether a <Label> element is being rendered. In tal caso, IsStyleAttributeDefined viene chiamato il metodo per verificare se Color è stato definito un attributo di stile <Label> per l'elemento.If so, the IsStyleAttributeDefined method is called to check whether a Color style attribute has been defined for the <Label> element. Se non Color è stato definito un attributo, il codice chiama questo overload AddStyleAttribute del metodo per aggiungere l' Color attributo all'attributo di stile e quindi impostarne il valore su red.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

Commenti

Utilizzare l' AddStyleAttribute overload AddStyleAttribute(HtmlTextWriterStyle, String) del metodo quando lo stile HtmlTextWriterStyle è un membro dell'enumerazione ed è noto prima della fase di esecuzione.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 HtmlTextWriter classe gestisce un elenco di stili per gli elementi di markup di cui esegue il rendering.The HtmlTextWriter class maintains a list of styles for the markup elements it renders. Quando viene RenderBeginTag chiamato il metodo, viene eseguito il rendering degli AddStyleAttribute stili aggiunti dal metodo al tag di apertura dell'elemento.When the RenderBeginTag method is called, any styles added by the AddStyleAttribute method are rendered to the opening tag of the element. L'elenco degli stili viene quindi cancellato.The list of styles is then cleared.

Il modello di codifica per il rendering degli elementi di markup è il seguente:The coding pattern for rendering markup elements is as follows:

  • Usare il AddStyleAttribute metodo per aggiungere eventuali attributi di stile all'elemento.Use the AddStyleAttribute method to add any style attributes to the element.

  • Usare il metodo RenderBeginTag.Use the RenderBeginTag method.

  • Usare altri metodi in base alle esigenze per eseguire il rendering del contenuto trovato tra i tag di apertura e di chiusura dell'elemento.Use other methods as needed to render the content found between the element opening and closing tags.

  • Usare il metodo RenderEndTag.Use the RenderEndTag method.

Vedi anche

AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle)

Aggiunge l'attributo di stile del markup specificato e il valore dell'attributo, oltre a un valore di enumerazione HtmlTextWriterStyle, al markup di apertura creato da una chiamata successiva del metodo 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)

Parametri

name
String String String String

Stringa contenente l'attributo di stile da aggiungere.A string that contains the style attribute to be added.

value
String String String String

Stringa contenente il valore da assegnare all'attributo.A string that contains the value to assign to the attribute.

key
HtmlTextWriterStyle HtmlTextWriterStyle HtmlTextWriterStyle HtmlTextWriterStyle

Oggetto HtmlTextWriterStyle che rappresenta l'attributo di stile da aggiungere.An HtmlTextWriterStyle that represents the style attribute to add.

Commenti

Utilizzare l' AddStyleAttribute overload AddStyleAttribute(String, String, HtmlTextWriterStyle) del metodo solo HtmlTextWriter quando si eredita dalla classe.Use the AddStyleAttribute overload of the AddStyleAttribute(String, String, HtmlTextWriterStyle) method only when inheriting from the HtmlTextWriter class. Consente di creare nuove name coppie e value per HtmlTextWriterStyle gli attributi.It enables you to create new name and value pairs for HtmlTextWriterStyle attributes.

Vedi anche

Si applica a