HyperLink.Target 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.
Obtém ou define a janela ou frame-alvo onde mostrar o conteúdo da página Web ligado quando o HyperLink controlo é clicado.
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, setPublic Property Target As StringValor de Propriedade
A janela ou frame alvo para carregar a página Web ligada quando o HyperLink controlo é clicado. Os valores devem começar com uma letra no intervalo de a a z (indistinto a maiúsculas), exceto os valores especiais listados na tabela seguinte, que começam com um sublinhado.
_blank | Renderiza o conteúdo numa nova janela sem frames. |
_parent | Renderiza o conteúdo no frameset pai imediato. |
_search | Renderiza o conteúdo no painel de pesquisa. |
_self | Renderiza o conteúdo no enquadramento com foco. |
_top | Renderiza o conteúdo na janela completa sem frames. |
Nota: Consulte a documentação do seu navegador para saber se o _search valor é suportado. Por exemplo, Microsoft Internet Explorer 5.0 e posteriores suportam o valor-alvo _search.
O valor padrão é uma cadeia vazia ("").
- Atributos
Exemplos
O exemplo seguinte demonstra como definir a Target propriedade para especificar a janela ou frame para mostrar a página associada ao 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"
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>
Observações
Use a Target propriedade para especificar a moldura ou janela que mostra a página Web ligada quando o HyperLink controlo é clicado. A página Web é especificada definindo a NavigateUrl propriedade.
Se esta propriedade não estiver definida, o navegador ou janela com foco atualiza-se quando o HyperLink controlo é clicado.
Note
A Target propriedade é renderizada como um target atributo. O target atributo sobre 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 o HyperLink tiver de ser compatível com XHTML 1.1. Para mais informações, consulte o tópico
Ao criar páginas Web acessíveis, recomenda-se vivamente que evite usar a Target propriedade para direcionar outra janela. Para mais informações, consulte Acessibilidade em Visual Studio e ASP.NET e ASP.NET Controlos e Acessibilidade.
