Exporter (0) Imprimer
Développer tout
Développer Réduire

LiteralMode, énumération

Remarque : cette énumération est nouvelle dans le .NET Framework version 2.0.

Indique comment le contenu d'un contrôle Literal est restitué.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public enum LiteralMode
public enum LiteralMode
public enum LiteralMode

 Nom de membreDescription
EncodeLe contenu du contrôle littéral est codé au format HTML. 
PassThroughLe contenu du contrôle littéral n'est pas modifié. 
TransformLes éléments de langage de balise non pris en charge pour le contrôle littéral sont supprimés. Si le contrôle littéral est restitué sur un navigateur qui prend en charge HTML ou XHTML, son contenu n'est pas modifié. 

L'énumération LiteralMode représente les modes de restitution du contenu d'un contrôle Literal. La propriété Mode utilise ces valeurs d'énumération pour définir le comportement du contenu de la propriété Text dans un contrôle Literal.

Si vous spécifiez PassThrough, tout le contenu de la propriété Text est passé au périphérique ou au navigateur sans aucune modification. Par exemple, si la propriété Text d'un contrôle Literal contient une balise <hr>, elle est envoyée à tous les périphériques et navigateurs, qu'elle soit prise en charge ou non.

Si vous spécifiez Encode, le contenu de la propriété Text est converti en une chaîne codée au format HTML avant d'être restitué. Par exemple, si la propriété Text d'un contrôle Literal contient une balise <hr>, elle est convertie en &lt;hr&gt; puis envoyée au périphérique ou au navigateur.

Si vous spécifiez Transform, le comportement du rendu de la propriété Text dépend du type de balise restitué. Lorsque le contrôle Literal est restitué pour un périphérique ou un navigateur qui prend en charge HTML ou XHTML, vous obtenez le même comportement, que vous spécifiez Transform ou PassThrough. Toutes les balises et éléments de la propriété Text sont restitués pour le navigateur qui effectue la demande.

Lorsque le contrôle Literal est restitué pour un langage de balisage autre que HTML ou XHTML, par exemple WML ou cHTML, vous pouvez utiliser la valeur Transform pour supprimer les éléments de balisage non pris en charge. Dans ce cas, tous les éléments de langage de balise de la propriété Text qui ne sont pas pris en charge dans le langage de balisage ciblé ne sont pas restitués pour le contrôle. Par exemple, si la propriété Text d'un contrôle Literal contient une balise <hr>, cette dernière est supprimée avant que le contenu soit envoyé à un périphérique WML. Si une balise non prise en charge contient du contenu, seule la balise est supprimée et le contenu est envoyé au périphérique ou au navigateur. Par exemple, si la propriété Text contient le contenu <XYZ>Test</XYZ>, les balises <XYZ> et </XYZ> sont supprimées tandis que le contenu Test est envoyé au périphérique ou au navigateur.

L'exemple de code suivant montre comment définir la propriété Mode d'un contrôle Literal. La propriété Mode a la valeur initiale Encode dans la syntaxe déclarative du contrôle. Une fois la page chargée, l'utilisateur peut cliquer sur un bouton pour affecter PassThrough à la propriété Mode. Le contenu de la propriété Text est restitué différemment.

<%@ Page Language="VB" %>

<html>
<head>
    <script runat=Server>
       
        Sub PassThroughButton_Click(ByVal sender As Object, ByVal e As EventArgs)
   
            Literal1.Mode = LiteralMode.PassThrough
            
            Label1.Text = "The contents of the Literal.Text property " + _
                          "passed through to the browser:"
           
        End Sub
     
   </script>
</head>
<body>
    <form ID="Form1" runat="server">
        
        <h3>Literal.Mode Property Example</h3>        
                             
        <asp:Label ID="Label1"
            Text="The HTML-encoded contents of the Literal.Text property:"
            runat=Server>     
        </asp:Label><br /><br />
        
        <asp:Literal ID="Literal1"
            Mode=Encode
            Text= "<b>bold</b><br/><i>italic</i><br/>"          
            runat=Server>
        </asp:Literal>
       
        <hr />
       
        <asp:Button ID="PassThroughButton"
            Text="Pass Through Mode"
            OnClick="PassThroughButton_Click"
            runat=Server>
        </asp:Button>
         
    </form>
</body>
</html>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft