LiteralMode Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie le rendu du contenu d’un contrôle Literal.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Héritage
Champs
| Nom | Valeur | Description |
|---|---|---|
| Transform | 0 | Les éléments de langage de balisage non pris en charge du contrôle littéral sont supprimés. Si le contrôle littéral est rendu sur un navigateur qui prend en charge HTML ou XHTML, le contenu du contrôle n’est pas modifié. |
| PassThrough | 1 | Le contenu du contrôle littéral n’est pas modifié. |
| Encode | 2 | Le contenu du contrôle littéral est codé au format HTML. |
Exemples
L’exemple suivant montre comment définir la Literal.Mode propriété. Elle est initialement définie 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é PassThroughsur . Cela entraîne le rendu du contenu de la Literal.Text propriété différemment.
<%@ 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 dans 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, le contenu entier de la Literal.Text propriété est transmis à 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.
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 et <hr> 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 affiché. Lorsque le Literal contrôle est rendu pour un appareil ou un navigateur prenant en charge HTML ou XHTML, la spécification Transform produit le même comportement que la PassThroughspécification . Toutes les balises de balisage et tous les éléments de la Literal.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 Transform valeur pour supprimer les éléments de balisage non pris en charge. Dans ce cas, tous 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 l’envoi du contenu à 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 balises et </XYZ> les <XYZ> balises sont supprimées pendant que le texte Test est envoyé à l’appareil ou au navigateur.
