HtmlTextWriter.OnStyleAttributeRender Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

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 Markupformatattribut und sein Wert im aktuellen Markupelement gerendert werden können.

protected:
 virtual bool OnStyleAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterStyle key);

protected virtual bool OnStyleAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterStyle key);

abstract member OnStyleAttributeRender : string * string * System.Web.UI.HtmlTextWriterStyle -> bool
override this.OnStyleAttributeRender : string * string * System.Web.UI.HtmlTextWriterStyle -> bool

Protected Overridable Function OnStyleAttributeRender (name As String, value As String, key As HtmlTextWriterStyle) As Boolean

Parameter

name: String

Eine Zeichenfolge mit dem Namen des Formatvorlagenattributs, der gerendert werden soll.

value: String

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

key: HtmlTextWriterStyle

Das dem Formatattribut zugeordnete HtmlTextWriterStyle.

Gibt zurück

Boolean

Immer true.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die OnStyleAttributeRender Methode außer Kraft setzen. Wenn ein Color Formatattribute gerendert wird, aber der Wert nicht purpleist, verwendet die Color OnStyleAttributeRender Außerkraftsetzung die Methode, um das AddStyleAttribute Color Attribut purpleauf festzulegen.

// If a color style attribute is to be rendered,
// compare its value to purple. If it is not set to
// purple, add the style attribute and set the value
// to purple, then return false.
protected override bool OnStyleAttributeRender(string name,
    string value,
    HtmlTextWriterStyle key)
{

    if (key == HtmlTextWriterStyle.Color)
    {
        if (string.Compare(value, "purple") != 0)
        {
            AddStyleAttribute("color", "purple");
            return false;
        }
    }

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

' If a color style attribute is to be rendered,
' compare its value to purple. If it is not set to
' purple, add the style attribute and set the value
' to purple, then return false.
Protected Overrides Function OnStyleAttributeRender(name As String, _
    value As String, _
    key As HtmlTextWriterStyle) _
As Boolean

    If key = HtmlTextWriterStyle.Color Then
        If [String].Compare(value, "purple") <> 0 Then
            AddStyleAttribute("color", "purple")
            Return False
        End If
    End If

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

Hinweise

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

Hinweise für Vererber

Wenn Sie von der HtmlTextWriter Klasse erben, können Sie die OnStyleAttributeRender(String, String, HtmlTextWriterStyle) Methode außer Kraft setzen, um false zu verhindern, dass ein Formatattribute überhaupt gerendert wird, auf einem bestimmten Element gerendert oder für eine bestimmte Markupsprache gerendert wird. Wenn Sie z. B. nicht möchten, dass das Objekt, das aus HtmlTextWriter dem color Formatattribute abgeleitet wird, in ein <p> Element gerendert wird, können Sie den OnStyleAttributeRender(String, String, HtmlTextWriterStyle) Übergeben überschreiben und zurückgebenfalse, wenn name der TagName Eigenschaftswert pübergeben color wird.

Gilt für

Freigeben über