Literal.Text Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la didascalia visualizzata nel controllo 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

Valore della proprietà

String

Didascalia visualizzata nel controllo Literal.

Implementazioni

Text
Attributi
BindableAttribute

Esempio

Nell'esempio seguente viene illustrato come utilizzare la proprietà per modificare a Text livello di codice la didascalia visualizzata nel Literal controllo .

Nota

L'esempio seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione aspx. Per altre informazioni sul modello di codice Web Forms, vedere Web Forms ASP.NET Page Code Model.For more information about the Web Forms code model, see Web Forms ASP.NET Page Code Model.


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

Commenti

Utilizzare la Text proprietà per specificare o determinare la didascalia visualizzata nel Literal controllo . In questo modo è possibile modificare la didascalia a livello di codice in fase di esecuzione.

La didascalia è decodificata in formato HTML a seconda del modo in cui si assegna un valore a questa proprietà. Se si assegna un valore tramite un attributo del Literal controllo, il valore viene decodificato in formato HTML prima che venga visualizzato. Ad esempio, <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> viene eseguito il rendering come "A B" nel browser. Tuttavia, se si imposta questa proprietà a livello di codice o posizionando il testo tra i tag di apertura e chiusura del controllo, la didascalia non viene decodificata in formato HTML. Ad esempio, <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> viene eseguito il rendering come "A B".

Attenzione

Questo controllo può essere usato per visualizzare l'input dell'utente, che potrebbe includere script client dannosi. Controllare le informazioni inviate da un client per lo script eseguibile, le istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare lo script e il codice HTML nell'input dell'utente. Vengono inoltre forniti controlli server di convalida per valutare l'input dell'utente. Per altre informazioni, vedere Sintassi del controllo server di convalida.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttribute Globalizzazione e localizzazione.

Si applica a

Vedi anche