Udostępnij za pośrednictwem


Label.Text Właściwość

Definicja

Pobiera lub ustawia zawartość tekstowa kontrolki Label .

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)>]
member this.Text : string with get, set
Public Overridable Property Text As String

Wartość właściwości

Zawartość tekstowa kontrolki. Wartość domyślna to Empty.

Implementuje

Atrybuty

Przykłady

W poniższym przykładzie pokazano, jak utworzyć nowe wystąpienie kontrolki Label i ustawić jej Text właściwość.

Uwaga

Poniższy przykładowy kod używa modelu kodu z jednym plikiem i może nie działać poprawnie, jeśli został skopiowany bezpośrednio do pliku za pomocą kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem .aspx. Aby uzyskać więcej informacji na temat modelu kodu formularzy internetowych, zobacz ASP.NET Model kodu strony formularzy internetowych.

<%@ 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>Label Example</title>
<script language="C#" runat="server">
         void Button1_Click(Object Sender, EventArgs e) {
            Label l2 = new Label();
            l2.Text = "This is a new Label";
            l2.BorderStyle = BorderStyle.Solid;    
            Page.Controls.Add(l2);
         }
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" 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>Label Example</title>
<script language="VB" runat="server">
         Sub Button1_Click(Sender As Object, e As EventArgs)
            Dim l2 As New Label()
            l2.Text = "This is a new Label"
            l2.BorderStyle = BorderStyle.Solid
            Page.Controls.Add(l2)
         End Sub
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" Runat="server"/>
 
     </form>
 </body>
 </html>

Uwagi

Text Użyj właściwości , aby określić lub określić zawartość tekstowa kontrolkiLabel. Ta właściwość jest często używana do programowego dostosowywania tekstu wyświetlanego w kontrolce Label .

Właściwość Text może zawierać kod HTML. Jeśli tak, kod HTML zostanie przekazany bez zmian do przeglądarki, gdzie może być interpretowany jako znaczniki, a nie jako tekst. Jeśli chcesz, aby przeglądarka wyświetlała znaczniki HTML jako zwykły tekst, możesz użyć HtmlEncode metody , jak pokazano w przykładzie dla przeglądu klasy. Możesz również użyć kontrolki Literal zamiast kontrolki Label i ustawić Mode właściwość na Encode.

Uwaga

Text Ustawienie właściwości spowoduje wyczyszczenie wszystkich innych kontrolek zawartych w kontrolceLabel.

Ważne

Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

Wartość tej właściwości, po ustawieniu, można automatycznie zapisać w pliku zasobów za pomocą narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute i ASP.NET globalizacji i lokalizacji.

Ta właściwość jest właściwością domyślną, z którą ControlParameter obiekt jest powiązany w czasie wykonywania. Aby uzyskać więcej informacji, zobacz ControlValuePropertyAttribute, ControlParameteri Using Parameters with Data Source Controls for Filtering (Używanie parametrów z kontrolkami źródła danych do filtrowania).

Dotyczy