HtmlTextWriter.OnStyleAttributeRender Método

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina se o atributo de estilo de marcação especificado e seu valor podem ser renderizados para o elemento da marcação atual.

protected:
 virtual bool OnStyleAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterStyle key);

protected virtual bool OnStyleAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterStyle key);

abstract member OnStyleAttributeRender : string * string * System.Web.UI.HtmlTextWriterStyle -> bool
override this.OnStyleAttributeRender : string * string * System.Web.UI.HtmlTextWriterStyle -> bool

Protected Overridable Function OnStyleAttributeRender (name As String, value As String, key As HtmlTextWriterStyle) As Boolean

Parâmetros

name: String

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

value: String

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

key: HtmlTextWriterStyle

O HtmlTextWriterStyle associado ao atributo de estilo.

Retornos

Boolean

Sempre true.

Exemplos

O exemplo de código a seguir mostra como substituir o OnStyleAttributeRender método. Se um Color atributo de estilo for renderizado, mas o Color valor não purplefor, a OnStyleAttributeRender substituição usará o AddStyleAttribute método para definir o Color atributo como purple.

// If a color style attribute is to be rendered,
// compare its value to purple. If it is not set to
// purple, add the style attribute and set the value
// to purple, then return false.
protected override bool OnStyleAttributeRender(string name,
    string value,
    HtmlTextWriterStyle key)
{

    if (key == HtmlTextWriterStyle.Color)
    {
        if (string.Compare(value, "purple") != 0)
        {
            AddStyleAttribute("color", "purple");
            return false;
        }
    }

    // If the style attribute is not a color attribute,
    // use the base functionality of the
    // OnStyleAttributeRender method.
    return base.OnStyleAttributeRender(name, value, key);
}

' If a color style attribute is to be rendered,
' compare its value to purple. If it is not set to
' purple, add the style attribute and set the value
' to purple, then return false.
Protected Overrides Function OnStyleAttributeRender(name As String, _
    value As String, _
    key As HtmlTextWriterStyle) _
As Boolean

    If key = HtmlTextWriterStyle.Color Then
        If [String].Compare(value, "purple") <> 0 Then
            AddStyleAttribute("color", "purple")
            Return False
        End If
    End If

    ' If the style attribute is not a color attribute,
    ' use the base functionality of the
    ' OnStyleAttributeRender method.
    Return MyBase.OnStyleAttributeRender(name, value, key)
End Function 'OnStyleAttributeRender

Comentários

A HtmlTextWriter implementação de classe do OnStyleAttributeRender método sempre retorna true. As OnStyleAttributeRender substituições podem determinar se um atributo de estilo será renderizado na página.

Notas aos Herdeiros

Se você herdar da HtmlTextWriter classe, poderá substituir o OnStyleAttributeRender(String, String, HtmlTextWriterStyle) método a ser retornado false para impedir que um atributo de estilo seja renderizado, ser renderizado em um elemento específico ou ser renderizado para uma linguagem de marcação específica. Por exemplo, se você não quiser que o objeto derivado renderize o color atributo de estilo para um <p> elemento, você poderá substituir e OnStyleAttributeRender(String, String, HtmlTextWriterStyle) retornar false quando name passar color e o valor da TagName propriedade for p.HtmlTextWriter

Aplica-se a

Compartilhar via