ChtmlTextWriter.OnAttributeRender Methode

  • Referenz

Definition

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

Bestimmt, ob das angegebene cHTML-Attribut und dessen Wert auf der anfordernden Seite gerendert werden. Sie können Attribute filtern, die Sie nicht auf Geräten rendern möchten, die cHTML unterstützen, indem Sie die OnAttributeRender(String, String, HtmlTextWriterAttribute)-Methode in Klassen überschreiben, die aus der ChtmlTextWriter-Klasse abgeleitet sind.

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

Parameter

name
String

Das zu rendernde cHTML-Attribut.

value
String

Der name zugewiesene Wert.

key
HtmlTextWriterAttribute

Der HtmlTextWriterAttribute, der name zugeordnet ist.

Gibt zurück

Boolean

true, um das Attribut und dessen Wert in den ChtmlTextWriter-Ausgabestream zu schreiben, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine benutzerdefinierte Klasse verwenden, die die OnAttributeRender Methode außer Kraft setzt, um zu verhindern, dass das bgcolor Attribut in den cHTML-Ausgabedatenstrom geschrieben wird. Anschließend wird die Funktionalität aufgerufen, die von der Basismethode OnAttributeRender aus der ChtmlTextWriter Klasse bereitgestellt wird, um sicherzustellen, dass auch das Standardverhalten verwendet wird.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ChtmlTextWriter Klasse bereitgestellt wird.

// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
    if (String.Equals("bgcolor", name))
    {
        return false;
    }
    
    // Call the ChtmlTextWriter version of the
    // the OnAttributeRender method.
    return base.OnAttributeRender(name, value, key);
}

' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is 
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
    If (String.Equals("bgcolor", name)) Then
        Return False
    End If

    ' Call the ChtmlTextWriter version of 
    ' the OnAttributeRender method.
    MyBase.OnAttributeRender(name, value, key)

End Function

Hinweise

Standardmäßig verhindert die OnAttributeRender Methode, dass global unterdrückte Attribute, die in der GlobalSuppressedAttributes Eigenschaft und elementspezifischen, unterdrückten Attributen aufgeführt werden, die in der Eigenschaft aufgeführt sind, in den SuppressedAttributes Ausgabedatenstrom geschrieben werden. Sie können das Verhalten der OnAttributeRender Methode in Klassen außer Kraft setzen, die aus der ChtmlTextWriter Klasse abgeleitet werden.

Gilt für

Siehe auch