ChtmlTextWriter.OnAttributeRender Methode
Definition
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 cHTML-Attribut und sein Wert auf der anfordernden Seite gerendert werden. Sie können die OnAttributeRender(String, String, HtmlTextWriterAttribute) Methode in Klassen überschreiben, die von der ChtmlTextWriter Klasse abgeleitet sind, um Attribute herauszufiltern, die Sie nicht auf Geräten rendern möchten, die cHTML unterstützen.
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 wert, der namezugewiesen ist.
Die HtmlTextWriterAttribute zugeordnete name.
Gibt zurück
true zum Schreiben des Attributs und des zugehörigen Werts in den ChtmlTextWriter Ausgabedatenstrom; andernfalls false.
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung einer benutzerdefinierten Klasse, 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 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 elementspezifisch aufgeführt sind, unterdrückte Attribute, die in der SuppressedAttributes Eigenschaft aufgeführt sind, in den Ausgabedatenstrom geschrieben werden. Sie können das Verhalten der OnAttributeRender Methode in Klassen überschreiben, die von der ChtmlTextWriter Klasse abgeleitet werden.