HyperLink.Target 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 janela de destino ou o quadro no qual exibir o conteúdo da página da Web vinculado quando o HyperLink controle é 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 da propriedade
A janela ou quadro de destino para carregar a página da Web vinculada quando o HyperLink controle é clicado. Os valores devem começar com uma letra no intervalo de a a z (não diferencia maiúsculas de minúsculas), exceto pelos 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 completa sem quadros. |
Observação: verifique a documentação do navegador para determinar se o _search valor tem suporte. Por exemplo, o Microsoft Internet Explorer 5.0 e posteriores dão suporte ao valor de _search destino.
O valor padrão é uma cadeia de caracteres vazia ("").
- Atributos
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 for compatível com XHTML HyperLink 1.1. Para obter mais informações, consulte o tópico XHTML Standards 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 outra janela. Para obter mais informações, consulte Acessibilidade no Visual Studio e ASP.NET e controles de ASP.NET e acessibilidade.
