HyperLinkColumn.NavigateUrl Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l'URL vers laquelle établir un lien quand un lien hypertexte a été sélectionné par un clic dans la colonne.
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 StringValeur de propriété
URL vers laquelle établir un lien quand un lien hypertexte a été sélectionné par un clic dans la colonne.
Exemples
L’exemple suivant montre comment utiliser la NavigateUrl propriété pour spécifier l’URL à lier pour les liens hypertexte dans le HyperLinkColumn. Notez que tous les liens hypertexte de la colonne sont liés à la même page.
Notes
L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page 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"
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>
L’exemple correspondant suivant est un exemple de page Web Forms vers laquelle créer un lien lorsque l’utilisateur clique sur un lien hypertexte de l’exemple précédent.
<%@ 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>
Remarques
Utilisez la NavigateUrl propriété pour spécifier l’URL à lier quand vous cliquez sur un lien hypertexte dans la colonne.
Notes
Lorsque cette propriété est définie, tous les liens hypertexte de la colonne partagent le même lien URL.
Pour fournir une URL distincte pour chaque lien hypertexte dans la colonne, utilisez la DataNavigateUrlField propriété .
Notes
Les DataNavigateUrlField propriétés et NavigateUrl ne peuvent pas être définies en même temps. Si les deux propriétés sont définies, la DataNavigateUrlField propriété est prioritaire.
