HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Methode

Definitie

Bepaalt of het opgegeven opmaakelement wordt weergegeven op de aanvraagpagina.

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

Parameters

name
String

Een tekenreeks met de naam van het element dat moet worden weergegeven.

key
HtmlTextWriterTag

De HtmlTextWriterTag gekoppelde aan het element.

Retouren

Altijd true.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de OnTagRender methode overschrijft. Als een Font element wordt weergegeven, gebruikt de OnTagRender onderdrukking de IsAttributeDefined methode om te bepalen of een Size kenmerk wordt weergegeven. Als dat niet zo is, wordt de AddAttribute methode gebruikt om een Size kenmerk te maken en de waarde ervan in te stellen op 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

Opmerkingen

De HtmlTextWriter klasse-implementatie van de OnTagRender methode retourneert truealtijd . De OnTagRender onderdrukkingen kunnen bepalen of een element wordt weergegeven op de pagina.

Notities voor overnemers

Als u de klasse overschrijft HtmlTextWriter , kunt u de OnTagRender(String, HtmlTextWriterTag) methode overschrijven om te false voorkomen dat een opmaakelement helemaal wordt weergegeven of voor een bepaalde opmaaktaal. Als u bijvoorbeeld niet wilt dat het object dat is afgeleid van HtmlTextWriter het element weer te geven, kunt u de <font> methode overschrijven die moet worden geretourneerd OnTagRender(String, HtmlTextWriterTag) wanneer een pagina wordt aangevraagd die een false element <font> bevat.

Van toepassing op

Zie ook