XhtmlTextWriter.IsValidFormAttribute(String) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Sprawdza atrybut XHTML, aby upewnić się, że można go renderować w tagu otwierania <form> elementu.

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

Parametry

attributeName

String

Nazwa atrybutu do sprawdzenia.

Zwraca

Boolean

true jeśli atrybut można zastosować do <form> elementu; w przeciwnym razie false.

Przykłady

Poniższy przykład kodu jest częścią większego przykładu, który tworzy kontrolkę niestandardową Label i kartę, która renderuje zawartość kontrolki jako XHTML.

W tym przykładzie kodu pokazano, jak utworzyć zmienną logiczną o nazwie attTest i ustawić ją na wartość zwracaną przez wywołanie IsValidFormAttribute metody z wartością parametru "style". IsValidFormAttribute Jeśli metoda zwróci truemetodę , style skojarzone z kontrolką są renderowane przy użyciu HtmlTextWriter.EnterStyle metod i HtmlTextWriter.ExitStyle . attTest Jeśli wartość to false, style nie są renderowane. Zamiast tego strona wyświetla tekst kontrolki, <br/> element renderowany przez WriteBreak metodę oraz ciąg tekstowy informujący użytkownika, że zawartość XHTML kontrolki została renderowana warunkowo.

Ten przykład kodu jest częścią większego przykładu podanego XhtmlTextWriter dla klasy.

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

Uwagi

Ta metoda jest przydatna do warunkowego renderowania atrybutu w zależności od tego, czy jest obsługiwana przez typ dokumentu XHTML urządzenia żądającego.