XhtmlTextWriter.IsValidFormAttribute(String) Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Active un attribut XHTML pour garantir qu'il peut être restitué dans la balise d'ouverture d'un élément <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

Paramètres

attributeName

String

Nom de l'attribut à activer.

Retours

Boolean

true si l'attribut peut s'appliquer à un élément <form> ; sinon, false.

Exemples

L’exemple de code suivant fait partie d’un exemple plus grand qui crée un contrôle personnalisé Label et un adaptateur qui restitue le contenu du contrôle en tant que XHTML.

Cet exemple de code montre comment créer une variable booléenne nommée attTest et la définir sur la valeur de retour qui résulte de l’appel de la IsValidFormAttribute méthode avec la valeur de paramètre « style ». Si la IsValidFormAttribute méthode retournetrue, les styles associés au contrôle sont rendus à l’aide des méthodes et HtmlTextWriter.ExitStyle des HtmlTextWriter.EnterStyle méthodes. Si la attTest valeur est false, les styles ne sont pas rendus. Au lieu de cela, la page affiche le texte du contrôle, un <br/> élément rendu par la WriteBreak méthode et une chaîne de texte informant l’utilisateur que le contenu XHTML du contrôle s’est rendu de manière conditionnelle.

Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

Cette méthode est utile pour restituer de manière conditionnelle un attribut selon qu’il est pris en charge par le type de document XHTML de l’appareil demandeur.