Cette documentation est archivée et n’est pas conservée.

HyperLinkColumn, classe

Type de colonne du contrôle DataGrid contenant un lien hypertexte pour chaque élément de la colonne.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class HyperLinkColumn : DataGridColumn
public class HyperLinkColumn extends DataGridColumn
public class HyperLinkColumn extends DataGridColumn

Utilisez le type de colonne HyperLinkColumn dans un contrôle DataGrid pour créer un lien hypertexte par ligne de DataGrid. Définissez la propriété Text de manière à ce qu'elle spécifie le texte de légende du lien. Pour spécifier l'URL à laquelle le lien hypertexte se dirige lorsqu'il est sélectionné par un clic, définissez la propriété NavigateUrl.

RemarqueRemarque

Si vous définissez les propriétés Text et NavigateUrl, tous les liens hypertexte de la colonne partagent la même légende et la même URL.

Il est également possible d'associer la légende le texte et l'URL des liens hypertexte de HyperLinkColumn à un champ situé dans une source de données au lieu de définir les propriétés Text et NavigateUrl. Ceci permet d'afficher une légende différente et de spécifier une URL différente par lien hypertexte de la colonne.

Utilisez la propriété DataTextField pour spécifier le champ d'une source de données à lier à la légende de texte des liens hypertexte de la colonne.

RemarqueRemarque

Les propriétés DataTextField et Text ne peuvent pas être définies toutes les deux en même temps. Si les deux propriétés sont définies, la propriété DataTextField est prioritaire.

Pour spécifier le champ à lier à l'URL du lien hypertexte, définissez la propriété DataNavigateUrlField.

RemarqueRemarque

Les propriétés DataNavigateUrlField et NavigateUrl ne peuvent pas être définies toutes les deux en même temps. Si les deux propriétés sont définies, la propriété DataNavigateUrlField est prioritaire.

La propriété Target permet de spécifier la fenêtre ou le frame dans lequel afficher le contenu de page Web associé au lien hypertexte sélectionné par un clic.

Lorsque vous utilisez une liaison de données, vous pouvez définir respectivement les propriétés DataTextFormatString et DataNavigateUrlFormatString pour mettre en forme la légende de texte et l'URL du lien hypertexte.

AttentionAttention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client malveillant. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l'entrée d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

L'exemple suivant montre comment créer HyperLinkColumn établissant un lien vers une page séparée.

RemarqueRemarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<html>

<head>

   <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 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>


L'exemple suivant affiche l'élément sélectionné dans l'exemple précédent.

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
 
   <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>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : LinkDemand. Valeur d'autorisation : Minimal.
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : InheritanceDemand. Valeur d'autorisation : Minimal.

System.Object
   System.Web.UI.WebControls.DataGridColumn
    System.Web.UI.WebControls.HyperLinkColumn

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: