Literal.Text Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Obtient ou définit la légende affichée dans le contrôle Literal.

public:
 property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Bindable(true)]
public string Text { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set

Public Property Text As String

Valeur de propriété

String

Légende affichée dans le contrôle Literal.

Implémente

Text

Attributs: BindableAttribute

Exemples

L’exemple suivant montre comment utiliser la Text propriété pour modifier par programmation la légende affichée dans le Literal contrôle.

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="C#" AutoEventWireup="True" %>

<!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 Example</title>
<script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {
         Literal1.Text="Welcome to ASP.NET!!";
      }

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           runat="server"/>

   </form>
</body>
</html>


<%@ Page Language="VB" AutoEventWireup="True" %>

<!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 Example</title>
<script runat="server">

      Sub ButtonClick(sender As Object, e As EventArgs)
      
         Literal1.Text="Welcome to ASP.NET!!"
      
      End Sub

   </script>

</head>
<body>
   <form id="form1" runat="server">
      <h3>Literal Example</h3>

      <asp:Literal id="Literal1"
           Text="Hello World!!"
           runat="server"/>

      <br /><br />

      <asp:Button id="Button1"
           Text="Change Literal Text"
           OnClick="ButtonClick"
           runat="server"/>

   </form>
</body>
</html>

Remarques

Utilisez la Text propriété pour spécifier ou déterminer la légende affichée dans le Literal contrôle. Cela vous permet de modifier par programmation la légende au moment de l’exécution.

La légende est décodée HTML en fonction de la façon dont vous attribuez une valeur à cette propriété. Si vous attribuez une valeur par le biais d’un attribut du Literal contrôle, la valeur est décodée HTML avant qu’elle ne s’affiche. Par exemple, <asp:Literal id="DisplayLiteral" Text="A B"/> est affiché sous la forme « A B » sur le navigateur. Toutefois, si vous définissez cette propriété par programmation ou en plaçant le texte entre les balises d’ouverture et de fermeture du contrôle, la légende n’est pas décodée HTML. Par exemple, <asp:Literal id="DisplayLiteral"> A B </asp:Literal> est rendu sous la forme « AB ».

Attention

Ce contrôle peut être utilisé pour afficher l’entrée utilisateur, ce qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou d’autres codes avant de l’afficher dans votre application. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur. Les contrôles de serveur de validation sont également fournis pour évaluer l’entrée utilisateur. Pour plus d’informations, consultez La syntaxe du contrôle serveur de validation.

La valeur de cette propriété, quand elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de concepteur. Pour plus d’informations, consultez LocalizableAttribute et globalisation et localisation.

S’applique à

Voir aussi

Vue d’ensemble du contrôle serveur web littéral

Partager via