HtmlTextWriter.OnAttributeRender Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Bestimmt, ob das angegebene Markup-Attribut und sein Wert im aktuellen Markupelement gerendert werden können.

protected:
 virtual bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);
protected virtual bool OnAttributeRender(string name, string value, System.Web.UI.HtmlTextWriterAttribute key);
abstract member OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
Protected Overridable Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean

Parameter

name
String

Eine Zeichenfolge, die den Namen des zu rendernden Attributs enthält.

value
String

Eine Zeichenfolge, die den Wert enthält, der dem Attribut zugewiesen ist.

key
HtmlTextWriterAttribute

Das HtmlTextWriterAttribute Markup-Attribut zugeordnet.

Gibt zurück

Boolean

Immer true.

Beispiele

Das folgende Codebeispiel zeigt, wie die OnAttributeRender Methode überschreibt wird. Wenn ein Size Attribut gerendert wird, aber der Size Wert nicht 30ptist, ruft die Überschreibung die OnAttributeRenderAddAttribute Methode auf, um ein Size Attribut hinzuzufügen und den Wert auf festzulegen 30pt.

// If a size attribute is to be rendered, compare its value to 30 point.
// If it is not set to 30 point, add the attribute and set the value to 30,
// then return false.
protected override bool OnAttributeRender(string name,
    string value,
    HtmlTextWriterAttribute key)
{

    if (key == HtmlTextWriterAttribute.Size)
    {
        if (string.Compare(value, "30pt") != 0)
        {
            AddAttribute("size", "30pt");
            return false;
        }
    }

    // If the attribute is not a size attribute, use
    // the base functionality of the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' If a size attribute is to be rendered, compare its value to 30 point.
' If it is not set to 30 point, add the attribute and set the value to 30
' then return false.
Protected Overrides Function OnAttributeRender(name As String, _
    value As String, _
    key As HtmlTextWriterAttribute) _
As Boolean

    If key = HtmlTextWriterAttribute.Size Then
        If [String].Compare(value, "30pt") <> 0 Then
            AddAttribute("size", "30pt")
            Return False
        End If
    End If

    ' If the attribute is not a size attribute, use
    ' the base functionality of the OnAttributeRender method.
    Return MyBase.OnAttributeRender(name, value, key)
End Function 'OnAttributeRender

Hinweise

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

Hinweise für Vererber

Wenn Sie von der HtmlTextWriter Klasse erben, können Sie die OnAttributeRender(String, String, HtmlTextWriterAttribute) Methode überschreiben, um false zu verhindern, dass ein Attribut überhaupt gerendert, für ein bestimmtes Element gerendert oder für ein bestimmtes Markup gerendert wird. Wenn Sie z. B. nicht möchten, dass das Objekt von dem Attribut in HtmlTextWriter Elementen gerendert wird, können Sie das bgcolor Übergeben und zurückgeben<table>, und OnAttributeRender(String, String, HtmlTextWriterAttribute)false der name Eigenschaftswert lautet bgcolor.TagNametable

Gilt für:

Weitere Informationen