Partager via


LiteralMode Énumération

Définition

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

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Héritage
LiteralMode

Champs

Encode 2

Le contenu du contrôle littéral est encodé au format HTML.

PassThrough 1

Le contenu du contrôle littéral n'est pas modifié.

Transform 0

Les é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é.

Exemples

L’exemple suivant montre comment définir la Literal.Mode propriété . Elle est initialement définie sur Encode dans la syntaxe déclarative du contrôle. Une fois la page chargée, l’utilisateur peut cliquer sur un bouton pour définir la Mode propriété sur PassThrough. Cela entraîne un rendu différent du contenu de la Literal.Text propriété.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal.Mode Property Example</title>
<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>

Remarques

L’énumération LiteralMode représente les modes que vous pouvez spécifier pour le rendu du contenu d’un Literal contrôle. La Literal.Mode propriété utilise ces valeurs d’énumération pour définir le comportement du contenu de la Literal.Text propriété .

Si vous spécifiez PassThrough, l’intégralité du contenu de la Literal.Text propriété est passée à l’appareil ou au navigateur sans aucune modification. Par exemple, si la Literal.Text propriété contient une <hr> balise, elle est envoyée à tous les appareils et navigateurs, qu’elle soit prise en charge ou non.

Si vous spécifiez Encode, le contenu de la Text propriété est converti en chaîne encodée html avant le rendu. Par exemple, si la Literal.Text propriété contient une <hr> balise, elle est convertie &lt;hr&gt; en et envoyée à l’appareil ou au navigateur.

Si vous spécifiez Transform, le comportement de rendu de la Literal.Text propriété dépend du type de balisage rendu. Lorsque le Literal contrôle est rendu pour un appareil ou un navigateur qui prend en charge HTML ou XHTML, la spécification Transform produit le même comportement que la spécification PassThroughde . Tous les éléments et balises de balisage de la Literal.Text propriété sont affichés pour le navigateur demandeur.

Lorsque le Literal contrôle est rendu pour un langage de balisage autre que HTML ou XHTML, tel que WML ou cHTML, vous pouvez utiliser la Transform valeur pour supprimer les éléments de balisage non pris en charge. Dans ce cas, les éléments de langage de balisage de la Literal.Text propriété qui ne sont pas pris en charge dans le langage de balisage ciblé ne sont pas rendus pour le contrôle. Par exemple, si la Literal.Text propriété contient une <hr> balise, la balise est supprimée avant que le contenu ne soit envoyé à un appareil WML. Si une balise non prise en charge contient du contenu, seule la balise est supprimée et le contenu est envoyé à l’appareil ou au navigateur. Par exemple, si la Literal.Text propriété contient le contenu <XYZ>Test</XYZ>, les <XYZ> balises et </XYZ> sont supprimées pendant que le texte Test est envoyé à l’appareil ou au navigateur.

S’applique à

Voir aussi