HyperLinkColumn.NavigateUrl 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 die URL ab, die beim Klicken auf den Link in der Spalte geöffnet werden soll, oder legt diese fest.
public:
virtual property System::String ^ NavigateUrl { System::String ^ get(); void set(System::String ^ value); };public virtual string NavigateUrl { get; set; }member this.NavigateUrl : string with get, setPublic Overridable Property NavigateUrl As StringEigenschaftswert
Die URL, die beim Klicken auf den Link in der Spalte geöffnet werden soll.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die NavigateUrl -Eigenschaft verwendet wird, um die URL anzugeben, mit der eine Verknüpfung für Hyperlinks in der angegeben werden HyperLinkColumnsoll. Beachten Sie, dass alle Links in der Spalte auf dieselbe Seite verweisen.
Hinweis
Das folgende Codebeispiel verwendet das Einzeldateicodemodell und 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"
NavigateUrl="detailspage.aspx"
Text="Click Me"
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"
NavigateUrl="detailspage.aspx"
Text="Click Me"
Target="_blank"/>
</Columns>
</asp:DataGrid>
</form>
</body>
</html>
Das folgende entsprechende Beispiel ist eine Web Forms-Beispielseite, auf die beim Klicken auf einen Link im vorherigen Beispiel eine Verknüpfung hergestellt werden kann.
<%@ 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>
<title>Details page for DataGrid</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Details page for DataGrid</h3>
Welcome to the new page.
</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>
<title>Details page for DataGrid</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Details page for DataGrid</h3>
Welcome to the new page.
</form>
</body>
</html>
Hinweise
Verwenden Sie die NavigateUrl -Eigenschaft, um die URL anzugeben, mit der eine Verknüpfung hergestellt werden soll, wenn auf einen Link in der Spalte geklickt wird.
Hinweis
Wenn diese Eigenschaft festgelegt ist, verwenden alle Hyperlinks in der Spalte denselben URL-Link.
Um eine separate URL für jeden Link in der Spalte bereitzustellen, verwenden Sie die DataNavigateUrlField -Eigenschaft.
Hinweis
Die DataNavigateUrlField Eigenschaften und NavigateUrl können nicht gleichzeitig festgelegt werden. Wenn beide Eigenschaften festgelegt sind, hat die DataNavigateUrlField Eigenschaft Vorrang.
