HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Método

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Compartilhar via