Compartir a través de


HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Método

Definición

Determina si el elemento de marcado especificado se va a representar en la página que realiza la solicitud.

protected:
 virtual bool OnTagRender(System::String ^ name, System::Web::UI::HtmlTextWriterTag key);
protected virtual bool OnTagRender (string name, System.Web.UI.HtmlTextWriterTag key);
abstract member OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
override this.OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
Protected Overridable Function OnTagRender (name As String, key As HtmlTextWriterTag) As Boolean

Parámetros

name
String

Cadena con el nombre del elemento que se ha de representar.

key
HtmlTextWriterTag

Control HtmlTextWriterTag asociado al elemento.

Devoluciones

Siempre es true.

Ejemplos

En el ejemplo de código siguiente se muestra cómo invalidar el OnTagRender método . Si se representa un Font elemento, la OnTagRender invalidación usa el IsAttributeDefined método para determinar si se representa un Size atributo. Si no es así, usa el AddAttribute método para crear un Size atributo y establecer su valor en 20pt.

// If a <font> element is to be rendered, check whether it contains
// a size attribute. If it does not, add one and set its value to
// 20 points, then return true.
protected override bool OnTagRender(string name, HtmlTextWriterTag key)
{

    if (key == HtmlTextWriterTag.Font)
    {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Size)))
        {
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt");
            return true;
        }
    }

    // If the element is not a <font> element, use
    // the base functionality of the OnTagRenderMethod.
    return base.OnTagRender(name, key);
}
' If a <font> element is to be rendered, check whether it contains
' a size attribute. If it does not, add one and set its value to
' 20 points, then return true.
Protected Overrides Function OnTagRender( _
    name As String, _
    key As HtmlTextWriterTag) _
As Boolean

    If (key = HtmlTextWriterTag.Font) Then
        If Not (IsAttributeDefined(HtmlTextWriterAttribute.Size)) Then
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt")
            Return True
        End If
    End If

    ' If the element is not a <font> element, use
    ' the base functionality of the OnTagRenderMethod.
    Return MyBase.OnTagRender(name, key)
End Function

Comentarios

La HtmlTextWriter implementación de clase del OnTagRender método siempre devuelve true. Las OnTagRender invalidaciones pueden determinar si un elemento se representará en la página.

Notas a los desarrolladores de herederos

Si hereda de la HtmlTextWriter clase , puede invalidar el OnTagRender(String, HtmlTextWriterTag) método para volver false para evitar que un elemento de marcado se represente en absoluto o para un lenguaje de marcado determinado. Por ejemplo, si no desea que el objeto derivado de HtmlTextWriter represente el <font> elemento, puede invalidar el OnTagRender(String, HtmlTextWriterTag) método para devolver false cuando se solicita una página que contiene un <font> elemento .

Se aplica a

Consulte también