ChtmlTextWriter.OnAttributeRender Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Determina si el atributo cHTML especificado y su valor se van a representar en la página que realiza la solicitud. Puede reemplazar el método OnAttributeRender(String, String, HtmlTextWriterAttribute) en clases que se deriven de la clase ChtmlTextWriter para filtrar los atributos que no desee representar en dispositivos que admitan 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

Atributo cHTML que se va a representar.

value

String

Valor asignado a name.

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute asociado a name.

Devoluciones

Boolean

Es true para escribir el atributo y su valor en el flujo de salida ChtmlTextWriter; en caso contrario, es false.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar una clase personalizada que invalida el OnAttributeRender método para evitar que el bgcolor atributo se escriba en el flujo de salida cHTML. A continuación, llama a la funcionalidad proporcionada por el método base OnAttributeRender de la ChtmlTextWriter clase para asegurarse de que también se usa su comportamiento predeterminado.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la ChtmlTextWriter clase .

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

Comentarios

De forma predeterminada, el OnAttributeRender método impide que los atributos suprimidos globalmente que se enumeran en la GlobalSuppressedAttributes propiedad y los atributos específicos del elemento que se enumeran en la SuppressedAttributes propiedad se escriban en el flujo de salida. Puede invalidar el comportamiento del OnAttributeRender método en las clases derivadas de la ChtmlTextWriter clase .

Consulte también

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)