Sdílet prostřednictvím

Label.Text Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví textový obsah Label ovládacího prvku.

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

Hodnota vlastnosti

String

Textový obsah ovládacího prvku. Výchozí hodnota je Empty.

Implementuje

Text
Atributy
BindableAttribute PersistenceModeAttribute

Příklady

Následující příklad ukazuje, jak vytvořit novou instanci Label ovládacího prvku a nastavit jeho Text vlastnost.

Poznámka:

Následující ukázka kódu používá model kódu s jedním souborem a při kopírování přímo do souboru s kódem nemusí správně fungovat. Tento vzorový kód musí být zkopírován do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webového formuláře najdete v tématu ASP.NET model kódu stránky webového formuláře.

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

Poznámky

Text Vlastnost slouží k určení nebo určení textového Label obsahu ovládacího prvku. Tato vlastnost se běžně používá k programovému přizpůsobení textu, který se zobrazuje v ovládacím Label prvku.

Vlastnost Text může obsahovat kód HTML. Pokud ano, html se předá prohlížeči beze změny, kde se může interpretovat jako revize, a ne jako text. Pokud chcete, aby prohlížeč zobrazoval kód HTML jako prostý text, můžete použít metodu HtmlEncode , jak je znázorněno v příkladu přehledu třídy. Můžete také použít Literal ovládací prvek místo Label ovládacího prvku a nastavit Mode vlastnost na Encode.

Poznámka:

Nastavení vlastnosti vymaže Text všechny ostatní ovládací prvky obsažené v ovládacím Label prvku.

Důležité

Tento ovládací prvek lze použít k zobrazení vstupu uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.

Hodnotu této vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace naleznete v tématu LocalizableAttribute a ASP.NET globalizace a lokalizace.

Tato vlastnost je výchozí vlastností, na kterou ControlParameter se objekt v době běhu sváže. Další informace naleznete v tématu ControlValuePropertyAttribute, ControlParametera Použití parametrů s ovládacími prvky zdroje dat pro filtrování.

Platí pro