Literal.Mode Propriété

Définition

Obtient ou définit une valeur d'énumération qui spécifie comment le contenu du contrôle Literal est rendu.

public:
 property System::Web::UI::WebControls::LiteralMode Mode { System::Web::UI::WebControls::LiteralMode get(); void set(System::Web::UI::WebControls::LiteralMode value); };
public System.Web.UI.WebControls.LiteralMode Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.LiteralMode with get, set
Public Property Mode As LiteralMode

Valeur de propriété

Une des valeurs d'énumération LiteralMode. La valeur par défaut est Transform.

Exceptions

Le type spécifié ne fait pas partie des valeurs d'énumération LiteralMode.

Exemples

L’exemple de code suivant montre comment définir la propriété d’un LiteralMode contrôle. La Mode propriété 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 le rendu du contenu de la Text propriété différemment.

Notes

L’exemple suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET Web Forms modèle de code de page.

<%@ 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

Utilisez la Mode propriété pour spécifier le mode de rendu du contenu d’un Literal contrôle. Cette propriété est définie à l’aide de l’une des valeurs d’énumération LiteralMode . Le tableau suivant répertorie les valeurs possibles.

Valeur Description
PassThrough Le contenu du contrôle n’est pas modifié.
Encode Le contenu du contrôle est converti en chaîne encodée html.
Transform Les éléments de langage de balisage non pris en charge sont supprimés du contenu du contrôle. Si le Literal contrôle est rendu sur un navigateur qui prend en charge html ou XHTML, son contenu n’est pas modifié.

Si vous spécifiez PassThrough, le contenu entier de la Text propriété est passé à l’appareil ou au navigateur sans apporter de modifications. Par exemple, si la Text propriété d’un Literal contrôle 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 Text propriété d’un Literal contrôle contient une <hr> balise, elle est convertie &lt;Hr&gt; et envoyée à l’appareil ou au navigateur.

Si vous spécifiez Transform, le comportement de rendu de la 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 PassThroughspécification . Tous les éléments et balises de balisage de la Text propriété sont rendus 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 valeur pour supprimer les Transform éléments de balisage non pris en charge. Dans ce cas, tous les éléments de langage de balisage de la 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 Text propriété d’un Literal contrôle 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 Text propriété contient le contenu <XYZ>Test</XYZ>, les <XYZ> balises et </XYZ> sont supprimées et le texte « Test » est envoyé à l’appareil ou au navigateur.

S’applique à

Voir aussi