Partilhar via

HtmlAnchor.Target Propriedade

  • Referência

Definição

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

Obtém ou define o nome da janela do navegador ou do quadro que exibe o conteúdo da página da Web à qual está vinculado quando o controle HtmlAnchor é 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 da propriedade

String

A janela ou quadro do navegador que exibe o conteúdo da página da Web vinculada quando o HtmlAnchor é clicado. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir demonstra como usar a Target propriedade para exibir a página que é navegada quando o HtmlAnchor controle é clicado em uma nova janela não estruturada.

<%@ 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>

Comentários

Use a Target propriedade para especificar a janela ou quadro de destino que exibe o conteúdo da página da Web vinculada quando o HtmlAnchor controle é clicado.

Observação

A Target propriedade é renderizada como um target atributo. O target atributo em 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 precisar estar em conformidade com o XHTML 1.1. Para obter mais informações, consulte Padrões XHTML no Visual Studio e ASP.NET.

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

O Target valor deve começar com uma letra no intervalo de A a Z (que não diferencia maiúsculas de minúsculas), exceto pelos valores especiais a seguir, que começam com um sublinhado.

Valor de destino Descrição
_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 valor _search . Por exemplo, o Microsoft Internet Explorer 5.0 e posterior dão suporte ao valor de destino _search .

Aplica-se a

Confira também