Partilhar via

HyperLink.Target Propriedade

  • Referência

Definição

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

Obtém ou define a janela ou o quadro de destino no qual deverá ser exibido o conteúdo da página da Web vinculada quando um usuário clicar no controle HyperLink.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Property Target As String

Valor da propriedade

String

A janela ou o quadro de destino para carregar a página da Web vinculada quando um usuário clicar no controle HyperLink. Os valores devem começar com uma letra no intervalo de A a Z (não diferencia maiúsculas de minúsculas), exceto para os valores especiais listados na tabela a seguir, que começam com um sublinhado.

_blank Renderiza o conteúdo em uma nova janela sem quadros.
_parent Renderiza o conteúdo no pai do conjunto de quadros imediato.
_search Renderiza o conteúdo no painel de pesquisa.
_self Renderiza o conteúdo no quadro com foco.
_top Renderiza o conteúdo na janela inteira sem quadros.

Observação: verifique a documentação do navegador para determinar se há suporte para o _search valor. Por exemplo, o Microsoft Internet Explorer 5.0 e posterior dão suporte ao valor de destino _search .

O valor padrão é uma cadeia de caracteres vazia ("").

Atributos
BindableAttribute TypeConverterAttribute

Exemplos

O exemplo a seguir demonstra como definir a Target propriedade para especificar a janela ou quadro para exibir a página associada ao HyperLink controle.

<%@ 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" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  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" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

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

Comentários

Use a Target propriedade para especificar o quadro ou a janela que exibe a página da Web vinculada quando o HyperLink controle é clicado. A página da Web é especificada definindo a NavigateUrl propriedade .

Se essa propriedade não estiver definida, o navegador ou a janela com foco será atualizado quando o HyperLink controle for clicado.

Observação

A Target propriedade é renderizada como um target atributo. O target atributo em anchor elementos não é permitido na definição de tipo de documento XHTML 1.1. Não defina a Target propriedade se a saída renderizada para deve HyperLink ser compatível com XHTML 1.1. Para obter mais informações, consulte o tópico Padrões XHTML no Visual Studio e ASP.NET.

Ao criar páginas da Web acessíveis, é altamente recomendável que você evite usar a Target propriedade para direcionar a outra janela. Para obter mais informações, consulte Acessibilidade no Visual Studio e ASP.NET e Controles de ASP.NET e Acessibilidade.

Aplica-se a

Confira também