HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Určuje, zda se zadaný prvek značky bude vykreslen na požadovanou stránku.

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

Parametry

name

String

Řetězec obsahující název prvku, který se má vykreslit.

key

HtmlTextWriterTag

Přidruženo HtmlTextWriterTag k prvku.

Návraty

Boolean

Vždy true.

Příklady

Následující příklad kódu ukazuje, jak přepsat metodu OnTagRender . Pokud se Font vykresluje prvek, OnTagRender přepsání používá metodu IsAttributeDefined k určení, zda Size se atribut vykresluje. Pokud ne, používá metodu AddAttribute k vytvoření atributu Size a nastavit jeho hodnotu na 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

Poznámky

Implementace HtmlTextWriter třídy OnTagRender metody vždy vrátí true. Přepsání OnTagRender může určit, zda bude prvek vykreslen na stránku.

Poznámky pro dědice

Pokud dědíte z HtmlTextWriter třídy, můžete přepsat metodu OnTagRender(String, HtmlTextWriterTag)false vrátit, aby se zabránilo vykreslení elementu revizí vůbec nebo pro určitý jazyk revizí. Pokud například nechcete objekt odvozený z HtmlTextWriter vykreslovat <font> prvek, můžete přepsat metodu OnTagRender(String, HtmlTextWriterTag) vrátit false , když je požadována stránka, která obsahuje <font> prvek.

Viz také

• TextWriter
• HtmlTextWriterTag