Condividi tramite

Literal.Text Proprietà

Definizione

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

Ottiene o imposta la didascalia visualizzata nel Literal controllo .

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 Literal controllo .

Implementazioni

Text
Attributi
BindableAttribute

Esempio

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

Annotazioni

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 Form, vedere ASP.NET modello di codice della pagina Web Form.


<%@ 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 in formato HTML a seconda della modalità di assegnazione di 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 inserendo il testo tra i tag di apertura e chiusura del controllo, la didascalia non è decodificata in 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. I controlli server di convalida vengono forniti anche 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