Label.Text Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin metin içeriğini Label alır veya ayarlar.

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

Özellik Değeri

String

Denetimin metin içeriği. Empty varsayılan değerdir.

Uygulamalar

Text
Öznitelikler
BindableAttribute PersistenceModeAttribute

Örnekler

Aşağıdaki örnekte, denetimin yeni bir örneğinin nasıl oluşturulacağı ve özelliğinin Label nasıl ayarlanacağı gösterilmektedir Text .

Not

Aşağıdaki kod örneği tek dosyalı kod modelini kullanır ve doğrudan arka planda kod dosyasına kopyalandığında düzgün çalışmayabilir. Bu kod örneği, .aspx uzantısına sahip boş bir metin dosyasına kopyalanmalıdır. Web Forms kod modeli hakkında daha fazla bilgi için bkz. ASP.NET Web Forms Sayfa Kodu Modeli.

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

Açıklamalar

Denetimin Text metin içeriğini Label belirtmek veya belirlemek için özelliğini kullanın. Bu özellik genellikle denetimde Label görüntülenen metni program aracılığıyla özelleştirmek için kullanılır.

Text özelliği HTML içerebilir. Bu durumda HTML, tarayıcıya değiştirilmeden geçirilir; burada metin olarak değil işaretleme olarak yorumlanabilir. Tarayıcının HTML işaretlemesini düz metin olarak görüntülemesini istiyorsanız, sınıfa genel bakış örneğinde gösterildiği gibi yöntemini kullanabilirsiniz HtmlEncode . Ayrıca denetimi yerine Label denetimini kullanabilir Literal ve özelliğini olarak EncodeayarlayabilirsinizMode.

Not

özelliğinin Text ayarlanması, denetimde Label yer alan diğer denetimleri temizler.

Önemli

Bu denetim, olası bir güvenlik tehdidi olan kullanıcı girişini görüntülemek için kullanılabilir. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.

Bu özelliğin değeri ayarlandığında, bir tasarımcı aracı kullanılarak otomatik olarak bir kaynak dosyasına kaydedilebilir. Daha fazla bilgi için bkz LocalizableAttribute . genelleştirme ve yerelleştirme ASP.NET.

Bu özellik, bir ControlParameter nesnenin çalışma zamanında bağlanacak varsayılan özelliktir. Daha fazla bilgi için bkz ControlValuePropertyAttribute. , ControlParameterve Filtreleme için Veri Kaynağı Denetimleri ile Parametreleri Kullanma.

Şunlara uygulanır