HtmlAnchor.Target Propriedade

Definição

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

Obtém ou define o nome da janela ou frame do navegador que mostra o conteúdo da página Web ligada quando o HtmlAnchor controlo é clicado.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String

Valor de Propriedade

String

A janela ou frame do navegador que mostra o conteúdo da página Web ligada quando é clicada HtmlAnchor . O padrão é uma cadeia vazia ("").

Exemplos

O exemplo de código seguinte demonstra como usar a Target propriedade para mostrar a página para a qual se navega quando o HtmlAnchor controlo é clicado numa nova janela sem moldura.

<%@ 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 runat="server">
        <title>ASP.NET Example</title>
    </head>
    <body>
      <form id="Form1" method="post" runat="server">
  
         <a href="http://www.microsoft.com"
            title="Open Microsoft site in a new window"
            target="_blank" 
            runat="server"> Enter site.</a>
  
       </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 runat="server">
        <title>ASP.NET Sample</title>
    </head>
   
    <body>
      <form id="Form1" method="post" runat="server">
  
         <a href="http://www.microsoft.com"
            target="_blank" 
            title="Open Microsoft.com site in a new window"
            runat="server"> Enter site.</a>
  
       </form>
     </body>
 
 </html>

Observações

Use a Target propriedade para especificar a janela ou frame de destino que mostra o conteúdo da página Web ligada quando o HtmlAnchor controlo é clicado.

Note

A Target propriedade é renderizada como um target atributo. O target atributo sobre a 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 HtmlAnchor tiver de estar em conformidade com o XHTML 1.1. Para mais informações, consulte XHTML Standards in Visual Studio e ASP.NET.

Ao criar páginas Web acessíveis, evite usar a Target propriedade para direcionar outra janela. Para mais informações, consulte ASP.NET Acessibilidade.

O Target valor deve começar com uma letra no intervalo de A a Z (indiferente a maiúsculas), exceto os valores especiais seguintes, que começam com um sublinhado.

Valor alvo Descrição
_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.

Note

Verifique a documentação do seu navegador para ver se o _search valor é suportado. Por exemplo, Microsoft Internet Explorer 5.0 e posteriores suportam o valor-alvo _search.

Aplica-se a

Ver também