HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bestimmt, ob das angegebene Markupelement auf der anfordernden Seite gerendert wird.

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

Parameter

name: String

Eine Zeichenfolge mit dem Namen des Elements, das gerendert werden soll.

key: HtmlTextWriterTag

Das dem Element zugeordnete HtmlTextWriterTag-Element.

Gibt zurück

Boolean

Immer true.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die OnTagRender Methode außer Kraft setzen. Wenn ein Element gerendert wird, verwendet die OnTagRender Außerkraftsetzung die IsAttributeDefined Methode, um zu bestimmen, ob ein Font Size Attribut gerendert wird. Wenn nicht, verwendet sie die AddAttribute Methode, um ein Size Attribut zu erstellen und den Wert auf 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

Hinweise

Die HtmlTextWriter Klassenimplementierung der OnTagRender Methode gibt immer zurück true. Die OnTagRender Außerkraftsetzungen können bestimmen, ob ein Element auf die Seite gerendert wird.

Hinweise für Vererber

Wenn Sie von der HtmlTextWriter Klasse erben, können Sie die OnTagRender(String, HtmlTextWriterTag) Methode außer Kraft setzen, um false zu verhindern, dass ein Markupelement überhaupt oder für eine bestimmte Markupsprache gerendert wird. Wenn Sie z. B. nicht möchten, dass das Objekt, das aus HtmlTextWriter dem <font> Element abgeleitet wird, zurückgegeben wird, können Sie die OnTagRender(String, HtmlTextWriterTag) Methode false außer Kraft setzen, wenn eine Seite angefordert wird, die ein <font> Element enthält.

Gilt für

Freigeben über