HyperLinkColumn.Target Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das Zielfenster oder den Zielframe ab, in dem der Inhalt der verknüpften Webseite dargestellt werden soll, wenn auf den Link in der Spalte geklickt wird, oder legt dieses bzw. diesen fest.
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 StringEigenschaftswert
Das Zielfenster oder der Zielframe, in dem die verknüpfte Webseite dargestellt werden soll, wenn auf einen Link in der Spalte geklickt wird. Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit dem Fokus aktualisiert.
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die Target -Eigenschaft verwendet wird, um das Fenster anzugeben, in dem der Inhalt der Webseite angezeigt werden soll, mit der verknüpft ist, wenn auf den Link in der Spalte geklickt wird. In diesem Beispiel wird die verknüpfte Webseite in einem neuen Fenster angezeigt.
Hinweis
Im folgenden Codebeispiel wird das Einzeldateicodemodell verwendet. Es funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer .aspx-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms-Seitencodemodell.
<%@ 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>
Im folgenden entsprechenden Beispiel wird das im vorherigen Beispiel ausgewählte Element angezeigt.
<%@ 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>
Hinweise
Verwenden Sie die Target -Eigenschaft, um den Rahmen oder das Fenster anzugeben, in dem die Webseite angezeigt wird, mit der bzw. das die verknüpfte Webseite angezeigt wird, wenn auf einen Link in der Spalte geklickt wird.
Wenn diese Eigenschaft nicht festgelegt ist, wird der Browser oder das Fenster mit dem Fokus aktualisiert, wenn auf einen Link in der Spalte geklickt wird.
Hinweis
Die Target Eigenschaft wird als target Attribut gerendert. Das target Attribut für anchor Elemente ist in der XHTML 1.1-Dokumenttypdefinition nicht zulässig. Legen Sie die Target -Eigenschaft nicht fest, wenn die gerenderte Ausgabe für XHTML HyperLinkColumn 1.1-kompatibel sein muss. Weitere Informationen finden Sie im Thema XHTML-Standards in Visual Studio und ASP.NET.
Beim Erstellen barrierefreier Webseiten wird dringend empfohlen, die Verwendung der Target -Eigenschaft für ein anderes Fenster zu vermeiden. Weitere Informationen finden Sie unter ASP.NET Barrierefreiheit.
Der Target Wert muss mit einem Buchstaben im Bereich von A bis Z beginnen (ohne Berücksichtigung der Groß-/Kleinschreibung), mit Ausnahme der folgenden speziellen Werte, die mit einem Unterstrich beginnen.
| Zielwert | BESCHREIBUNG |
|---|---|
_blank |
Stellt den Inhalt in einem neuen Fenster ohne Frames dar. |
_parent |
Stellt den Inhalt im unmittelbar übergeordneten Frameset dar. |
_search |
Gibt den Inhalt im Suchbereich wieder. |
_self |
Stellt den Inhalt in dem Frame dar, der den Fokus besitzt. |
_top |
Stellt den Inhalt im gesamten Fenster ohne Frames dar. |
Hinweis
Sie können der Browserdokumentation entnehmen, ob der _search-Wert unterstützt wird. Internet Explorer 5.0 und höher unterstützen beispielsweise den _search Zielwert.
Gilt für:
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für