Compartir vía

HyperLink.Target Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la ventana o el marco de destino donde debe mostrarse el contenido de la página Web de vinculación al hacer clic en el control 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 de propiedad

String

Ventana o marco de destino donde se ha de cargar la página Web de vinculación al hacer clic en el control HyperLink. Los valores deben comenzar por una letra comprendida entre la a y la z (sin distinción de mayúsculas y minúsculas), a excepción de los valores especiales que se enumeran en la siguiente tabla, que comienzan por un carácter de subrayado.

_blank Representa el contenido en una nueva ventana sin marcos.
_parent Representa el contenido en el conjunto de marcos principal inmediato.
_search Representa el contenido en el panel de búsqueda.
_self Representa el contenido en el marco con foco.
_top Representa el contenido en una ventana completa sin marcos.

Nota: Compruebe la documentación del explorador para determinar si se admite el _search valor. Por ejemplo, Microsoft Internet Explorer 5.0 y versiones posteriores admiten el valor de destino _search.

El valor predeterminado es una cadena vacía ("").

Atributos
BindableAttribute TypeConverterAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la Target propiedad para especificar la ventana o marco para mostrar la página asociada al HyperLink control .

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

Comentarios

Utilice la Target propiedad para especificar el marco o la ventana que muestra la página web vinculada a cuando se hace clic en el HyperLink control. La página web se especifica estableciendo la NavigateUrl propiedad .

Si no se establece esta propiedad, el explorador o la ventana con foco se actualiza cuando se hace clic en el HyperLink control.

Nota

La Target propiedad se representa como un target atributo. No target se permite el atributo en anchor los elementos en la definición de tipo de documento XHTML 1.1. No establezca la Target propiedad si la salida representada para HyperLink debe ser compatible con XHTML 1.1. Para obtener más información, consulte el tema Estándares XHTML en Visual Studio y ASP.NET.

Al crear páginas web accesibles, se recomienda encarecidamente evitar el uso de la Target propiedad para tener como destino otra ventana. Para obtener más información, vea Accesibilidad en Visual Studio y ASP.NET y ASP.NET Controles y accesibilidad.

Se aplica a

Consulte también