HtmlTextWriter.OnStyleAttributeRender(String, String, HtmlTextWriterStyle) Method

Definition

Bestimmt, ob das angegebene Markupformatattribut und sein Wert im aktuellen Markupelement gerendert werden können.Determines whether the specified markup style attribute and its value can be rendered to the current markup element.

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

Parameters

name
String

Eine Zeichenfolge mit dem Namen des Formatvorlagenattributs, der gerendert werden soll.A string containing the name of the style attribute to render.

value
String

Eine Zeichenfolge mit dem Wert, der dem Formatattribut zugewiesen wird.A string containing the value that is assigned to the style attribute.

key
HtmlTextWriterStyle

Das dem Formatattribut zugeordnete HtmlTextWriterStyle.The HtmlTextWriterStyle associated with the style attribute.

Returns

Boolean

Immer true.Always true.

Examples

Im folgenden Codebeispiel wird gezeigt, wie die OnStyleAttributeRender-Methode überschrieben wird.The following code example shows how to override the OnStyleAttributeRender method. Wenn ein Color Style-Attribut gerendert wird, der Color Wert jedoch nicht purpleist, verwendet die OnStyleAttributeRender Überschreibung die AddStyleAttribute-Methode, um das Color-Attribut auf purplefestzulegen.If a Color style attribute is rendered, but the Color value is not purple, the OnStyleAttributeRender override uses the AddStyleAttribute method to set the Color attribute to purple.

// 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

Remarks

Die HtmlTextWriter-Klassen Implementierung der OnStyleAttributeRender-Methode gibt immer truezurück.The HtmlTextWriter class implementation of the OnStyleAttributeRender method always returns true. Die OnStyleAttributeRender Überschreibungen können bestimmen, ob ein Format Attribut auf der Seite gerendert wird.The OnStyleAttributeRender overrides can determine whether a style attribute will be rendered to the page.

Notes to Inheritors

Wenn Sie von der HtmlTextWriter-Klasse erben, können Sie die OnStyleAttributeRender(String, String, HtmlTextWriterStyle)-Methode überschreiben, um false zurückzugeben, um zu verhindern, dass ein Format Attribut überhaupt gerendert wird, dass es für ein bestimmtes Element gerendert oder für eine bestimmte Markup Sprache gerendert wird.If you inherit from the HtmlTextWriter class, you can override the OnStyleAttributeRender(String, String, HtmlTextWriterStyle) method to return false to prevent a style attribute from being rendered at all, being rendered on a particular element, or being rendered for a particular markup language. Wenn Sie z. b. nicht möchten, dass das Objekt, das von HtmlTextWriter abgeleitet ist, das color Style-Attribut in einem <p>-Element wieder gibt, können Sie die OnStyleAttributeRender(String, String, HtmlTextWriterStyle) überschreiben und false zurückgeben, wenn name color und der TagName-Eigenschafts Wert pist.For example, if you do not want the object that is derived from HtmlTextWriter to render the color style attribute to a <p> element, you can override the OnStyleAttributeRender(String, String, HtmlTextWriterStyle) and return false when name passes color and the TagName property value is p.

Applies to

See also