HtmlTextWriter.AddStyleAttribute Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Adiciona um atributo de estilo de marcação à marca de abertura do elemento que o objeto HtmlTextWriter cria com uma chamada subsequente ao método RenderBeginTag.

Sobrecargas

AddStyleAttribute(String, String)	Adiciona o atributo de estilo de marcação especificado e o valor do atributo para a marcação de abertura criada por uma chamada subsequente para o método RenderBeginTag.
AddStyleAttribute(HtmlTextWriterStyle, String)	Adiciona o atributo de estilo de marcação associado ao valor HtmlTextWriterStyle especificado e o valor do atributo para a marcação de abertura criada por uma chamada subsequente para o método RenderBeginTag.
AddStyleAttribute(String, String, HtmlTextWriterStyle)	Adiciona o atributo de estilo de marcação especificado e o valor do atributo, juntamente com um valor de enumeração HtmlTextWriterStyle, à marcação de abertura criada por uma chamada subsequente para o método RenderBeginTag.

AddStyleAttribute(String, String)

Adiciona o atributo de estilo de marcação especificado e o valor do atributo para a marcação de abertura criada por uma chamada subsequente para o método 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)

Parâmetros

name

String

Uma cadeia de caracteres que contém o atributo de estilo para adicionar.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

Exemplos

O exemplo de código a seguir mostra como usar a RenderBeginTag sobrecarga do AddStyleAttribute(String, String) método para renderizar e color estilizar font-size atributos em um <p> elemento. Este exemplo de código usa a HtmlTextWriter classe para renderizar o conteúdo do controle.

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

Comentários

Use a AddStyleAttribute sobrecarga do AddStyleAttribute(String, String) método quando o estilo não for um membro da HtmlTextWriterStyle enumeração ou não for conhecido até o tempo de execução.

A HtmlTextWriter classe mantém uma lista de estilos para os elementos de marcação que renderiza. Quando o RenderBeginTag método é chamado, todos os estilos adicionados pelo AddStyleAttribute método são renderizados para a marca de abertura do elemento. Em seguida, a lista de estilos é desmarcada.

O padrão de codificação para renderizar elementos de marcação é o seguinte:

• Use o AddStyleAttribute método para adicionar quaisquer atributos de estilo ao elemento.

• Use o método RenderBeginTag.

• Use outros métodos conforme necessário para renderizar o conteúdo encontrado entre as marcas de abertura e fechamento do elemento.

• Use o método RenderEndTag.

Confira também

• TextWriter
• HtmlTextWriterStyle
• RenderBeginTag

AddStyleAttribute(HtmlTextWriterStyle, String)

Adiciona o atributo de estilo de marcação associado ao valor HtmlTextWriterStyle especificado e o valor do atributo para a marcação de abertura criada por uma chamada subsequente para o método 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)

Parâmetros

key

HtmlTextWriterStyle

Um HtmlTextWriterStyle que representa o atributo de estilo a ser adicionado ao fluxo de saída.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

Exemplos

O exemplo de código a seguir demonstra como usar parte de uma substituição do RenderBeginTag método em uma classe derivada da HtmlTextWriter classe. O código verifica se um <Label> elemento está sendo renderizado. Nesse caso, o IsStyleAttributeDefined método é chamado para verificar se um Color atributo de estilo foi definido para o <Label> elemento. Se um Color atributo não tiver sido definido, o código chamará essa sobrecarga do AddStyleAttribute método para adicionar o Color atributo ao atributo de estilo e, em seguida, defina seu valor como 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

Comentários

Use a AddStyleAttribute sobrecarga do AddStyleAttribute(HtmlTextWriterStyle, String) método quando o estilo for membro da HtmlTextWriterStyle enumeração e for conhecido antes do tempo de execução.

A HtmlTextWriter classe mantém uma lista de estilos para os elementos de marcação que renderiza. Quando o RenderBeginTag método é chamado, todos os AddStyleAttribute estilos adicionados pelo método são renderizados para a marca de abertura do elemento. Em seguida, a lista de estilos é desmarcada.

O padrão de codificação para renderizar elementos de marcação é o seguinte:

• Use o AddStyleAttribute método para adicionar quaisquer atributos de estilo ao elemento.

• Use o método RenderBeginTag.

• Use outros métodos conforme necessário para renderizar o conteúdo encontrado entre as marcas de abertura e fechamento do elemento.

• Use o método RenderEndTag.

Confira também

• TextWriter
• HtmlTextWriterStyle
• RenderBeginTag

AddStyleAttribute(String, String, HtmlTextWriterStyle)

Adiciona o atributo de estilo de marcação especificado e o valor do atributo, juntamente com um valor de enumeração HtmlTextWriterStyle, à marcação de abertura criada por uma chamada subsequente para o método 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)

Parâmetros

name

String

Uma cadeia de caracteres que contém o atributo de estilo a adicionar.

value

String

Uma cadeia de caracteres que contém o valor a ser atribuído ao atributo.

key

HtmlTextWriterStyle

Um HtmlTextWriterStyle que representa o atributo de estilo a adicionar.

Comentários

Use a AddStyleAttribute sobrecarga do AddStyleAttribute(String, String, HtmlTextWriterStyle) método somente ao herdar da HtmlTextWriter classe. Ele permite que você crie novos name pares para value HtmlTextWriterStyle atributos.

Confira também

• TextWriter
• RenderBeginTag
• HtmlTextWriterStyle