HtmlTextWriter.OnAttributeRender Methode

  • Referenz

Definition

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

Bestimmt, ob das angegebene Markupattribut 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 mit dem Namen des Attributs, das gerendert werden soll.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.

key
HtmlTextWriterAttribute

Das dem Markupattribut zugeordnete HtmlTextWriterAttribute.

Gibt zurück

Boolean

Immer true.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die OnAttributeRender -Methode überschrieben wird. Wenn ein Size Attribut gerendert wird, der Size Wert jedoch nicht 30ptist, ruft die OnAttributeRender Überschreibung die AddAttribute -Methode auf, um ein Size Attribut hinzuzufügen und dessen 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 -Klasse erben HtmlTextWriter , können Sie die OnAttributeRender(String, String, HtmlTextWriterAttribute) zurückzugebende false Methode überschreiben, um 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 von HtmlTextWriter abgeleitete Objekt das bgcolor Attribut für <table> Elemente rendert, können Sie überschreiben OnAttributeRender(String, String, HtmlTextWriterAttribute) und zurückgeben false , wenn name der -Wert durchläuft bgcolor und der TagName -Eigenschaftswert ist table.

Gilt für:

Weitere Informationen