HtmlTextWriter.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 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.
Das dem Markupattribut zugeordnete HtmlTextWriterAttribute.
Gibt zurück
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 30pt
ist, 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
.