Compartir a través de

HyperLinkField.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 se va a mostrar la página Web vinculada al hacer clic en un hipervínculo de un objeto HyperLinkField.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Overridable Property Target As String

Valor de propiedad

String

Ventana o el marco de destino donde debe cargarse la página web vinculada al hacer clic en un hipervínculo de un control HyperLinkField. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido esta propiedad.

Atributos
TypeConverterAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la Target propiedad para especificar una ventana de destino en la que mostrar el contenido de la página web asociada a un hipervínculo en un HyperLinkField objeto . La página web vinculada se muestra en una nueva ventana cuando se hace clic en el hipervínculo.


<%@ Page language="C#" %>

<!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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentarios

Utilice la Target propiedad para especificar la ventana o marco en el que se mostrará el contenido web vinculado a un hipervínculo cuando se haga clic en ese hipervínculo.

Los valores deben comenzar con una letra en el intervalo de A a Z (sin distinción entre mayúsculas y minúsculas), excepto los valores especiales enumerados en la tabla siguiente, cada uno de los cuales comienza con un carácter de subrayado.

Value Descripción
_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 el valor _search es compatible. Por ejemplo, Microsoft Internet Explorer 5.0 y versiones posteriores admiten el valor de _search destino.

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 propiedad si la Target salida representada para el HyperLinkField objeto 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 dirigirse a otra ventana. Para obtener más información, consulte accesibilidad de ASP.NET.

Se aplica a

Consulte también