HyperLinkColumn.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 el marco de destino donde se ha de mostrar el contenido de la página Web a la que se vincula al hacer clic en el hipervínculo de la columna.
public:
virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };public virtual string Target { get; set; }[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }member this.Target : string with 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 donde se debe cargar la página Web a la que se vincula al hacer clic en un hipervínculo de la columna. El valor predeterminado es una cadena vacía ("") que actualiza la ventana o el marco con el foco.
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo usar la Target propiedad para especificar la ventana para mostrar el contenido de la página web vinculada a cuando se hace clic en el hipervínculo de la columna. En este ejemplo se muestra la página web vinculada en una nueva ventana.
Nota
En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de formularios Web Forms, consulte ASP.NET modelo de código de página de formularios web forms.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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>HyperLinkColumn Example</title>
<script runat="server">
ICollection CreateDataSource()
{
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
for (int i = 0; i < 3; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = (Double)i * 1.23;
dt.Rows.Add(dr);
}
DataView dv = new DataView(dt);
return dv;
}
void Page_Load(Object sender, EventArgs e)
{
MyDataGrid.DataSource = CreateDataSource();
MyDataGrid.DataBind();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkColumn Example</h3>
<asp:DataGrid id="MyDataGrid"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
AutoGenerateColumns="false"
runat="server">
<HeaderStyle BackColor="#aaaadd"/>
<Columns>
<asp:HyperLinkColumn
HeaderText="Select an Item"
DataNavigateUrlField="IntegerValue"
DataNavigateUrlFormatString="detailspage.aspx?id={0}"
DataTextField="PriceValue"
DataTextFormatString="{0:c}"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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>HyperLinkColumn Example</title>
<script runat="server">
Function CreateDataSource() As ICollection
Dim dt As DataTable = New DataTable()
Dim dr As DataRow
Dim i As Integer
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
For i = 0 to 2
dr = dt.NewRow()
dr(0) = i
dr(1) = CDbl(i) * 1.23
dt.Rows.Add(dr)
Next i
Dim dv As DataView = New DataView(dt)
Return dv
End Function
Sub Page_Load(sender As Object, e As EventArgs)
MyDataGrid.DataSource = CreateDataSource()
MyDataGrid.DataBind()
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkColumn Example</h3>
<asp:DataGrid id="MyDataGrid"
BorderColor="black"
BorderWidth="1"
GridLines="Both"
AutoGenerateColumns="false"
runat="server">
<HeaderStyle BackColor="#aaaadd"/>
<Columns>
<asp:HyperLinkColumn
HeaderText="Select an Item"
DataNavigateUrlField="IntegerValue"
DataNavigateUrlFormatString="detailspage.aspx?id={0}"
DataTextField="PriceValue"
DataTextFormatString="{0:c}"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
En el siguiente ejemplo correspondiente se muestra el elemento seleccionado en el ejemplo anterior.
<%@ 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>Details page for DataGrid</title>
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
Label1.Text = "You selected item: " + Request.QueryString["id"];
}
</script>
</head>
<body>
<h3>Details page for DataGrid</h3>
<asp:Label id="Label1"
runat="server"/>
</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>Details page for DataGrid</title>
<script runat="server">
Sub Page_Load(sender As Object, e As EventArgs)
Label1.Text = "You selected item: " & Request.QueryString("id")
End Sub
</script>
</head>
<body>
<h3>Details page for DataGrid</h3>
<asp:Label id="Label1"
runat="server"/>
</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 un hipervínculo de la columna.
Si no se establece esta propiedad, se actualiza el explorador o la ventana con foco cuando se hace clic en un hipervínculo de la columna.
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 HyperLinkColumn 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.
El Target valor debe comenzar con una letra en el intervalo de A a Z (sin distinción entre mayúsculas y minúsculas), excepto los siguientes valores especiales, que comienzan con un carácter de subrayado.
| Valor del objetivo | 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
Consulte la documentación del explorador para determinar si admite el valor _search. Por ejemplo, Internet Explorer 5.0 y versiones posteriores admiten el _search valor de destino.
