Label.Text Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 nemusí správně fungovat, pokud je zkopírován přímo do souboru kódu na pozadí. Tento vzorový kód musí být zkopírován do prázdného textového souboru s příponou .aspx. Další informace o modelu kódu Web Forms najdete v tématu ASP.NET Web Forms model kódu stránky.

<%@ 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 Pomocí vlastnosti určete nebo určete textový obsah Label ovládacího prvku. Tato vlastnost se běžně používá k programovému přizpůsobení textu, který je zobrazen v ovládacím Label prvku.

Vlastnost Text může obsahovat HTML. Pokud ano, kód 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 značky HTML jako prostý text, můžete použít metodu HtmlEncode , jak je znázorněno v příkladu pro přehled 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 uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

Hodnota této vlastnosti, pokud je nastavená, se dá automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématu LocalizableAttribute a ASP.NET Globalizace a lokalizace.

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

Platí pro