Literal.Text Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia podpis wyświetlany w kontrolce 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

Wartość właściwości

String

Podpis wyświetlany w kontrolce Literal .

Implementuje

Text
Atrybuty
BindableAttribute

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Text właściwości programowo zmienić podpis wyświetlany w kontrolce Literal .

Uwaga

W poniższym przykładzie użyto modelu kodu pojedynczego pliku i może nie działać poprawnie, jeśli skopiowano bezpośrednio do pliku kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem aspx. Aby uzyskać więcej informacji na temat modelu kodu Web Forms, zobacz ASP.NET Web Forms Page Code Model (Model kodu strony ASP.NET 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>

Uwagi

Text Użyj właściwości , aby określić lub określić podpis wyświetlany w kontrolceLiteral. Dzięki temu można programowo zmienić podpis w czasie wykonywania.

Podpis jest dekodowany w formacie HTML w zależności od sposobu przypisywania wartości do tej właściwości. Jeśli przypiszesz wartość za pomocą atrybutu Literal kontrolki, wartość jest zdekodowana w formacie HTML, zanim zostanie wyświetlona. Na przykład <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> jest renderowany jako "A B" w przeglądarce. Jeśli jednak ustawisz tę właściwość programowo lub umieszczając tekst między znacznikami otwierania i zamykania kontrolki, podpis nie jest dekodowany w formacie HTML. Na przykład <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> jest renderowany jako "AB ".

Przestroga

Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, które mogą obejmować złośliwy skrypt klienta. Sprawdź wszelkie informacje wysyłane z klienta do skryptu wykonywalnego, instrukcji SQL lub innego kodu przed wyświetleniem go w aplikacji. ASP.NET udostępnia funkcję weryfikacji żądań wejściowych w celu blokowania skryptu i kodu HTML w danych wejściowych użytkownika. Dostępne są również kontrolki serwera sprawdzania poprawności w celu oceny danych wejściowych użytkownika. Aby uzyskać więcej informacji, zobacz Validation Server Control Syntax (Składnia kontroli serwera weryfikacji).

Wartość tej właściwości, po ustawieniu, można zapisać automatycznie w pliku zasobów przy użyciu narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute temat Globalizacja i Lokalizacja.

Dotyczy

Zobacz też