Condividi tramite

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 usare la proprietà per modificare a livello di codice la Text didascalia visualizzata nel Literal controllo.

Nota

Nell'esempio seguente viene usato 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 ASP.NET modello di codice della pagina Web Forms.


<%@ 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 a livello di codice la didascalia in fase di esecuzione.

La didascalia è decodificata 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 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 inserendo il testo tra i tag di apertura e chiusura del controllo, la didascalia non è decodificata 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 utente, che potrebbe includere script client dannosi. Controllare tutte le informazioni inviate da un client per script eseguibili, istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare script e HTML nell'input utente. I controlli server di convalida vengono forniti anche per valutare l'input utente. Per altre informazioni, vedere Sintassi del controllo server di convalida.

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

Si applica a

Vedi anche