Label.Text Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o conteúdo de texto do Label controlo.

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

Valor de Propriedade

String

O conteúdo do texto do controlo. O valor predefinido é Empty.

Implementações

Text
Atributos
BindableAttribute PersistenceModeAttribute

Exemplos

O exemplo seguinte demonstra como criar uma nova instância do Label controlo e definir a sua Text propriedade.

Note

O exemplo de código seguinte utiliza o modelo de código de ficheiro único e pode não funcionar corretamente se for copiado diretamente para um ficheiro code-behind. Este exemplo de código deve ser copiado para um ficheiro de texto vazio que tenha uma extensão .aspx. Para mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Page Code Model.

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

Observações

Use a Text propriedade para especificar ou determinar o conteúdo do texto do Label controlo. Esta propriedade é frequentemente usada para personalizar programaticamente o texto que é exibido no Label controlo.

A Text propriedade pode incluir HTML. Se o fizer, o HTML será passado inalterado para o navegador, onde pode ser interpretado como marcação e não como texto. Se quiser que o navegador mostre a marcação HTML como texto simples, pode usar o HtmlEncode método, como mostrado no exemplo da visão geral da classe. Também pode usar o Literal controlo em vez do Label controlo, e definir a Mode propriedade para Encode.

Note

Definir a Text propriedade irá eliminar quaisquer outros controlos contidos no Label controlo.

Importante

Este controlo pode ser usado para mostrar a entrada do utilizador, que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, consulte LocalizableAttribute e ASP.NET Globalização e Localização.

Esta propriedade é a propriedade padrão à qual um ControlParameter objeto se associa em tempo de execução. Para mais informações, veja ControlValuePropertyAttribute, ControlParameter, e Utilização de Parâmetros com Controlo de Fonte de Dados para Filtragem.

Aplica-se a