ChtmlTextWriter.OnAttributeRender Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Determina se o atributo cHTML especificado e o seu valor são renderizados na página solicitante. Podes sobrescrever o OnAttributeRender(String, String, HtmlTextWriterAttribute) método em classes que derivam da ChtmlTextWriter classe para filtrar atributos que não queres renderizar em dispositivos que suportem 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 para renderizar.

value
String

O valor atribuído a name.

key
HtmlTextWriterAttribute

O associado HtmlTextWriterAttribute a name.

Devoluções

Boolean

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

Exemplos

O exemplo de código seguinte demonstra como usar uma classe personalizada que sobrepõe o OnAttributeRender método para impedir que o bgcolor atributo seja escrito no fluxo de saída cHTML. Depois, chama a funcionalidade fornecida pelo método base OnAttributeRender da ChtmlTextWriter classe para garantir que o seu comportamento padrão também é utilizado.

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

Observações

Por defeito, o OnAttributeRender método impede que atributos globalmente suprimidos listados na GlobalSuppressedAttributes propriedade e os atributos suprimidos específicos de elemento listados na SuppressedAttributes propriedade sejam escritos no fluxo de saída. Podes sobrescrever o comportamento do OnAttributeRender método em classes que derivam da ChtmlTextWriter classe.

Aplica-se a

Ver também