HyperLink.Text Propriedade

Definição

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

Recebe ou define a legenda do texto para o HyperLink 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

A legenda do texto para o HyperLink controlo. O valor padrão é uma cadeia vazia ("").

Atributos
BindableAttribute PersistenceModeAttribute

Exemplos

O exemplo seguinte demonstra como usar a Text propriedade para especificar o texto a mostrar para o HyperLink controlo.

<%@ 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>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">


    <h3>HyperLink Sample</h3>

    Click on the HyperLink:<br />  

    <asp:HyperLink id="hyperlink1" 
                   NavigateUrl="http://www.microsoft.com"
                   Text="Microsoft Official Site"
                   Target="_new"
                   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>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

    <h3>HyperLink Sample</h3>

    Click on the HyperLink:<br />  

    <asp:HyperLink id="hyperlink1" 
                   NavigateUrl="http://www.microsoft.com"
                   Text="Microsoft Official Site"
                   Target="_new"
                   runat="server"/>       

</form>
</body>
</html>

Observações

O HyperLink controlo pode ser apresentado como texto ou imagem. Use a Text propriedade para especificar o texto a mostrar para o HyperLink controlo.

Se ambas as Text propriedades e ImageUrl forem definidas, a ImageUrl propriedade tem precedência. Se a imagem não estiver disponível, o texto na Text propriedade é exibido. Em navegadores que suportam funcionalidades ToolTip, a Text propriedade também se torna a ToolTip.

Caution

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.

Aplica-se a

Ver também