HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Určuje, zda se zadaný element revize vykreslí 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 elementu, který se má vykreslit.

key
HtmlTextWriterTag

Přidruženo HtmlTextWriterTag k prvku.

Návraty

Boolean

Vždy hodnota true.

Příklady

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

Poznámky pro dědice

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

Platí pro

Viz také