HyperLinkField.Target Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la ventana o marco de destino en el que se va a mostrar la página web vinculada cuando se hace clic en un hipervínculo de un HyperLinkField objeto.
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, setPublic Overridable Property Target As StringValor de propiedad
Ventana o marco de destino en el que se carga la página web vinculada cuando se hace clic en un hipervínculo de .HyperLinkField El valor predeterminado es una cadena vacía (""), que indica que esta propiedad no está establecida.
- Atributos
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 el marco en el que se va a mostrar el contenido web vinculado a un hipervínculo cuando se hace 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.
| Importancia | Descripción |
|---|---|
_blank |
Representa el contenido en una nueva ventana sin marcos. |
_parent |
Representa el contenido en el elemento primario del conjunto de marcos inmediato. |
_search |
Representa el contenido en el panel de búsqueda. |
_self |
Representa el contenido en el marco con el foco. |
_top |
Representa el contenido en la 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 _search valor de destino.
Nota:
La Target propiedad se representa como un target atributo. No se permite el target 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 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 ASP.NET Accesibilidad.
