XhtmlTextWriter.IsValidFormAttribute(String) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Prüft ein XHTML-Attribut darauf, ob es im öffnenden Tag eines <form>-Elements gerendert werden kann.

public:
 override bool IsValidFormAttribute(System::String ^ attributeName);

public override bool IsValidFormAttribute (string attributeName);

override this.IsValidFormAttribute : string -> bool

Public Overrides Function IsValidFormAttribute (attributeName As String) As Boolean

Parameter

attributeName

String

Der zu überprüfende Attributname.

Gibt zurück

Boolean

true, wenn das Attribut auf ein <form>-Element angewendet werden kann, andernfalls false.

Beispiele

Das folgende Codebeispiel ist Teil eines größeren Beispiels, das ein benutzerdefiniertes Label Steuerelement und einen Adapter erstellt, der den Inhalt des Steuerelements als XHTML rendert.

In diesem Codebeispiel wird veranschaulicht, wie eine boolesche Variable mit dem Namen attTest erstellt und auf den Rückgabewert festgelegt wird, der sich aus dem Aufruf der IsValidFormAttribute Methode mit dem Parameterwert "style" ergibt. Wenn die IsValidFormAttribute -Methode zurückgibt true, werden die Stile, die dem Steuerelement zugeordnet sind, mit den HtmlTextWriter.EnterStyle Methoden und HtmlTextWriter.ExitStyle gerendert. Wenn der attTest Wert ist false, werden die Formatvorlagen nicht gerendert. Stattdessen zeigt die Seite den Text für das Steuerelement, ein <br/> Element, das von der WriteBreak -Methode gerendert wird, und eine Textzeichenfolge an, die den Benutzer darüber informiert, dass der XHTML-Inhalt des Steuerelements bedingt gerendert wurde.

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

protected override void Render(HtmlTextWriter writer)
{
    // Create an instance of the XhtmlTextWriter class,
    // named w, and cast the HtmlTextWriter passed 
    // in the writer parameter to w.
    XhtmlTextWriter w = new XhtmlTextWriter(writer);

    // Create a string variable, named value, to hold
    // the control's Text property value.
    String value = Control.Text;

    // Create a Boolean variable, named attTest,
    // to test whether the Style attribute is 
    // valid in the page that the control is
    // rendered to.
    Boolean attTest = w.IsValidFormAttribute("style");

    // Check whether attTest is true or false.
    // If true, a style is applied to the XHTML
    // content. If false, no style is applied.
    if (attTest)
        w.EnterStyle(Control.ControlStyle);

    // Write the Text property value of the control,
    // a <br> element, and a string. Consider encoding the value using WriteEncodedText.
    w.Write(value);
    w.WriteBreak();
    w.Write("This control conditionally rendered its styles for XHTML.");

    // Check whether attTest is true or false.
    // If true, the XHTML style is closed.
    // If false, nothing is rendered.
    if (attTest)
        w.ExitStyle(Control.ControlStyle);
}

' Override the Render method.
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

    ' Create an instance of the XhtmlTextWriter class, 
    ' named w, and cast the HtmlTextWriter passed 
    ' in the writer parameter to w.
    Dim w As XhtmlTextWriter = New XhtmlTextWriter(writer)

    ' Create a string variable, named value, to hold
    ' the control's Text property value.
    Dim value As String = Control.Text

    ' Create a Boolean variable, named attTest,
    ' to test whether the Style attribute is 
    ' valid in the page that the control is
    ' rendered to.
    Dim attTest As Boolean = w.IsValidFormAttribute("style")

    ' Check whether attTest is true or false.
    ' If true, a style is applied to the XHTML
    ' content. If false, no style is applied.
    If (attTest = True) Then
        w.EnterStyle(Control.ControlStyle)
    End If

    ' Write the Text property value of the control,
    ' a <br> element, and a string. Consider encoding the value using WriteEncodedText.
    w.Write(value)
    w.WriteBreak()
    w.Write("This control conditionally rendered its styles for XHTML.")

    ' Check whether attTest is true or false.
    ' If true, the XHTML style is closed.
    ' If false, nothing is rendered.
    If (attTest = True) Then
        w.ExitStyle(Control.ControlStyle)
    End If

End Sub

Hinweise

Diese Methode ist nützlich, um ein Attribut bedingt zu rendern, je nachdem, ob es vom XHTML-Dokumenttyp des anfordernden Geräts unterstützt wird.