Vue d'ensemble du contrôle serveur Web Literal
Mise à jour : novembre 2007
Vous pouvez utiliser un contrôle serveur Web Literal comme conteneur pour un autre contenu sur la page.
Cette rubrique contient les sections suivantes :
Scénarios
Contexte
Exemples de code
Référence de Classe
Scénarios
Le contrôle Literal est le plus souvent utilisé lors de l'ajout dynamique de contenu à la page.
Retour au début
Contexte
Le contrôle Literal représente une option parmi plusieurs pour l'ajout de contenu à une page. Pour le contenu statique, vous pouvez ajouter directement un balisage à une page sous forme HTML, sans utiliser de conteneur. Toutefois, si vous souhaitez ajouter du contenu dynamiquement, vous devez l'ajouter à un conteneur. Les conteneurs typiques sont le contrôle Label, le contrôle Literal, le contrôle Panel et le contrôle PlaceHolder.
La différence entre le contrôle Literal et le contrôle Label est que le contrôle Literal n'ajoute pas d'éléments HTML au texte. (Le contrôle Label restitue un élément span.) En conséquence, le contrôle Literal ne prend en charge aucun attribut de style, même pas des attributs de position. Toutefois, le contrôle Literal vous permet de spécifier si le contenu est codé.
Les contrôles Panel et PlaceHolder sont rendus comme éléments div qui créent des blocs discrets dans la page, contrairement à un rendu en ligne comme le font les contrôles Label et Literal.
En général, utilisez un contrôle Literal lorsque vous souhaitez restituer directement du texte et des contrôles dans une page sans balisage supplémentaire.
Codage du contenu dans le contrôle Literal
Le contrôle Literal prend en charge la propriété Mode qui spécifie comment le contrôle gère le balisage que vous lui ajoutez. Vous pouvez affecter à la propriété Mode les valeurs suivantes :
Transform. Tout balisage que vous ajoutez au contrôle est transformé conformément au protocole du navigateur qui effectue la demande. Ce paramètre est utile si vous restituez le contenu sur des appareils mobiles qui utilisent un autre protocole que HTML.
PassThrough. Tout balisage que vous ajoutez au contrôle est restitué tel quel au navigateur.
Encode. Tout balisage que vous ajoutez au contrôle est codé à l'aide de la méthode HtmlEncode qui convertit le codage HTML en sa représentation textuelle. Par exemple, une balise <b> est restituée sous la forme <b>. Le codage est utile lorsque vous souhaitez que le navigateur affiche le balisage au lieu de l'interpréter. Le codage est également utile pour la sécurité, pour aider à empêcher la balise malveillante d'être exécutée dans le navigateur. Il est recommandé si vous affichez des chaînes d'une source non fiable. Pour plus d'informations, consultez Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML.
Exemples de code
Comment : ajouter des contrôles serveur Web Literal à une page Web Forms (Visual Studio)
Référence de Classe
Le tableau suivant répertorie les classes liées au contrôle Literal.
Member |
Description |
|---|---|
Classe principale du contrôle |
Retour au début