Literal.Text Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a legenda exibida no controle Literal.
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Bindable(true)]
public string Text { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, setPublic Property Text As StringValor da propriedade
A legenda exibida no controle Literal.
Implementações
- Atributos
Exemplos
O exemplo a seguir demonstra como usar a Text propriedade para alterar programaticamente a legenda exibida no Literal controle .
Observação
O exemplo 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 para um arquivo de texto vazio que tenha uma extensão de .aspx. Para obter mais informações sobre o modelo de código do 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>Literal Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
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>Literal Example</title>
<script runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Literal1.Text="Welcome to ASP.NET!!"
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
Comentários
Use a Text propriedade para especificar ou determinar a legenda exibida no Literal controle . Isso permite que você altere programaticamente a legenda em tempo de execução.
A legenda é decodificada em HTML dependendo de como você atribui um valor a essa propriedade. Se você atribuir um valor por meio de um atributo do Literal controle , o valor será decodificado em HTML antes de ser exibido. Por exemplo, <asp:Literal id="DisplayLiteral" Text="A B"/> é renderizado como "A B" no navegador. No entanto, se você definir essa propriedade programaticamente ou colocando o texto entre as marcas de abertura e fechamento do controle, a legenda não será decodificada em HTML. Por exemplo, <asp:Literal id="DisplayLiteral"> A B </asp:Literal> é renderizado como "A B".
Cuidado
Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado. Verifique as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo. ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear script e HTML na entrada do usuário. Controles de servidor de validação também são fornecidos para avaliar a entrada do usuário. Para obter mais informações, consulte Sintaxe de controle do servidor de validação.
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 LocalizableAttributee Globalização e Localização.
