ChtmlTextWriter.OnAttributeRender Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Determina se o atributo cHTML especificado e seu valor são renderizados para a página solicitante. Você pode substituir o método OnAttributeRender(String, String, HtmlTextWriterAttribute) em classes que derivam da classe ChtmlTextWriter para filtrar os atributos que não deseja renderizar em dispositivos com suporte para cHTML.

protected:
 override bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected override bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool

Protected Overrides Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

Parâmetros

name

String

O atributo cHTML a ser renderizado.

value

String

O valor atribuído a name.

key

HtmlTextWriterAttribute

O HtmlTextWriterAttribute associado a name.

Retornos

Boolean

true para gravar o atributo e seu valor no fluxo de saída ChtmlTextWriter; caso contrário, false.

Exemplos

O exemplo de código a seguir demonstra como usar uma classe personalizada que substitui o OnAttributeRender método para impedir que o bgcolor atributo seja gravado no fluxo de saída cHTML. Em seguida, ele chama a funcionalidade fornecida pelo método base OnAttributeRender da ChtmlTextWriter classe para garantir que seu comportamento padrão também seja usado.

Este exemplo de código faz parte de um exemplo maior fornecido para a ChtmlTextWriter classe.

// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
    if (String.Equals("bgcolor", name))
    {
        return false;
    }
    
    // Call the ChtmlTextWriter version of the
    // the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is 
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
    If (String.Equals("bgcolor", name)) Then
        Return False
    End If

    ' Call the ChtmlTextWriter version of 
    ' the OnAttributeRender method.
    MyBase.OnAttributeRender(name, value, key)

End Function

Comentários

Por padrão, o OnAttributeRender método impede que atributos suprimidos globalmente listados na GlobalSuppressedAttributes propriedade e atributos suprimidos específicos do elemento listados na SuppressedAttributes propriedade sejam gravados no fluxo de saída. Você pode substituir o comportamento do OnAttributeRender método em classes derivadas da ChtmlTextWriter classe.

Confira também

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)