HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Determina se o elemento de marcação especificado será renderizado para a página solicitante.

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

Uma cadeia de caracteres que contém o nome do elemento a renderizar.

key
HtmlTextWriterTag

O HtmlTextWriterTag associado ao elemento.

Retornos

Boolean

Sempre true.

Exemplos

O exemplo de código a seguir mostra como substituir o OnTagRender método. Se um Font elemento estiver sendo renderizado, a OnTagRender substituição usará o IsAttributeDefined método para determinar se um Size atributo está sendo renderizado. Caso contrário, ele usa o AddAttribute método para criar um Size atributo e definir seu valor como 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

Comentários

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

Notas aos Herdeiros

Se você herdar da HtmlTextWriter classe, poderá substituir o OnTagRender(String, HtmlTextWriterTag) método a ser retornado false para impedir que um elemento de marcação seja renderizado em tudo ou para uma linguagem de marcação específica. Por exemplo, se você não quiser que o objeto derivado HtmlTextWriter renderize o <font> elemento, poderá substituir o OnTagRender(String, HtmlTextWriterTag) método a ser retornado false quando uma página for solicitada que contenha um <font> elemento.

Aplica-se a

Confira também