Label.Text Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define o conteúdo do texto do controle 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

Valor da propriedade

String

O conteúdo do texto do controle. O valor padrão é Empty.

Implementações

Text
Atributos
BindableAttribute PersistenceModeAttribute

Exemplos

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

Observação

O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado em um arquivo de texto vazio que tenha uma extensão .aspx. Para obter mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Modelo de Código de Página.

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

Comentários

Use a Text propriedade para especificar ou determinar o conteúdo do texto do Label controle. Essa propriedade é comumente usada para personalizar programaticamente o texto exibido no Label controle .

A Text propriedade pode incluir HTML. Se isso acontecer, o HTML será passado inalterado para o navegador, onde pode ser interpretado como marcação e não como texto. Se você quiser que o navegador exiba a marcação HTML como texto sem formatação, use o HtmlEncode método , conforme mostrado no exemplo para a visão geral da classe. Você também pode usar o Literal controle em vez do Label controle e definir a Mode propriedade como Encode.

Observação

Definir a Text propriedade limpará todos os outros controles contidos no Label controle.

Importante

Esse controle pode ser usado para exibir a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer. Para obter mais informações, consulte LocalizableAttribute e ASP.NET Globalização e Localização.

Essa propriedade é a propriedade padrão à qual um ControlParameter objeto se associa em tempo de execução. Para obter mais informações, consulte ControlValuePropertyAttribute, ControlParametere Usando parâmetros com controles de fonte de dados para filtragem.

Aplica-se a