XhtmlTextWriter.IsValidFormAttribute(String) Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Controlla un attributo XHTML per assicurare che sia possibile eseguirne il rendering nel tag di apertura di un elemento <form>.

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

Parametri

attributeName

String

Nome di attributo da controllare.

Restituisce

Boolean

true se è possibile applicare l'attributo a un elemento <form>. In caso contrario, false.

Esempio

L'esempio di codice seguente fa parte di un esempio più ampio che crea un controllo personalizzato Label e un adattatore che esegue il rendering del contenuto del controllo come XHTML.

In questo esempio di codice viene illustrato come creare una variabile booleana denominata attTest e impostarla sul valore restituito risultante dalla chiamata al IsValidFormAttribute metodo con il valore del parametro "style". Se il IsValidFormAttribute metodo restituisce true, viene eseguito il rendering degli stili associati al controllo utilizzando i HtmlTextWriter.EnterStyle metodi e HtmlTextWriter.ExitStyle . Se il attTest valore è false, gli stili non vengono sottoposti a rendering. La pagina visualizza invece il testo del controllo, un <br/> elemento di cui viene eseguito il WriteBreak rendering dal metodo e una stringa di testo che informa l'utente che il contenuto XHTML del controllo è stato sottoposto a rendering condizionale.

Questo esempio di codice fa parte di un esempio più ampio fornito per la XhtmlTextWriter classe .

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

Commenti

Questo metodo è utile per eseguire il rendering condizionale di un attributo a seconda che sia supportato dal tipo di documento XHTML del dispositivo richiedente.