Literal.Text Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define a legenda mostrada no Literal controlo.
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 de Propriedade
A legenda apareceu no Literal controlo.
Implementações
- Atributos
Exemplos
O exemplo seguinte demonstra como usar a Text propriedade para alterar programaticamente a legenda apresentada no Literal controlo.
Note
O exemplo 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 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>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>
Observações
Use a Text propriedade para especificar ou determinar a legenda apresentada no Literal controlo. Isto permite-te alterar programaticamente a legenda em tempo de execução.
A legenda é decodificada em HTML dependendo de como atribuir um valor a esta propriedade. Se atribuir um valor através de um atributo do Literal controlo, o valor é 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 definir esta propriedade programaticamente ou colocando o texto entre as etiquetas de abertura e fecho do controlo, a legenda não é decodificada em HTML. Por exemplo, <asp:Literal id="DisplayLiteral"> A B </asp:Literal> é apresentado como "A B".
Atenção
Este controlo pode ser usado para mostrar a entrada do utilizador, que pode incluir scripts de cliente maliciosos. Verifique qualquer informação enviada por um cliente para scripts executáveis, instruções SQL ou outro código antes de a exibir na sua aplicação. ASP.NET fornece uma funcionalidade de validação de pedidos de entrada para bloquear scripts e HTML na entrada do utilizador. São também fornecidos controlos de servidor de validação para avaliar a entrada do utilizador. Para mais informações, consulte Sintaxe de Controlo do Servidor de Validação.
O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, veja LocalizableAttributeGlobalização e Localização.
