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, mit der eine Verknüpfung hergestellt werden soll, wenn auf einen Link in der Spalte geklickt wird, 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, mit der eine Verknüpfung hergestellt werden soll, wenn auf einen Link in der Spalte geklickt wird.
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 HyperLinkColumnn.V. hergestellt werden soll. Beachten Sie, dass alle Links in der Spalte mit derselben Seite verknüpft sind.
Hinweis
Im folgenden Codebeispiel wird das Codemodell mit einer Datei verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter ASP.NET Web Forms Page Code Model.
<%@ 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 Beispielwebformularseite, mit der eine Verknüpfung hergestellt werden kann, wenn im vorherigen Beispiel auf einen Link geklickt wird.
<%@ 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 Links in der Spalte denselben URL-Link.
Verwenden Sie die DataNavigateUrlField Eigenschaft, um eine separate URL für jeden Link in der Spalte bereitzustellen.
Hinweis
Die DataNavigateUrlField Eigenschaften können NavigateUrl nicht gleichzeitig festgelegt werden. Wenn beide Eigenschaften festgelegt sind, hat die DataNavigateUrlField Eigenschaft Vorrang.
