HyperLinkColumn Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Type de colonne pour le contrôle DataGrid qui contient un lien hypertexte pour chaque élément dans la colonne.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

Héritage: Object

DataGridColumn
HyperLinkColumn

Exemples

L’exemple suivant montre comment créer un HyperLinkColumn lien vers une page distincte.

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 Web Forms Modèle de code de page.

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

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

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

Remarques

Utilisez le HyperLinkColumn type de colonne dans un DataGrid contrôle pour créer un lien hypertexte pour chaque ligne du DataGrid. Définissez la Text propriété pour spécifier le texte de légende du lien hypertexte. Pour spécifier l’URL vers laquelle établir un lien lorsque vous cliquez sur le lien hypertexte, définissez la NavigateUrl propriété .

Notes

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

Vous pouvez également lier la légende du texte et l’URL des liens hypertexte dans le HyperLinkColumn à un champ dans une source de données au lieu de définir les Text propriétés et NavigateUrl . Cela vous permet d’afficher une autre légende et de spécifier une URL différente pour chaque lien hypertexte dans la colonne.

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

Notes

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

Spécifiez le champ à lier à l’URL du lien hypertexte en définissant 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.

La Target propriété vous permet de spécifier la fenêtre ou le cadre pour afficher le contenu de la page web lié lorsque vous cliquez sur le lien hypertexte.

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

Attention

Ce contrôle peut être utilisé pour afficher l’entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l’entrée utilisateur avant d’afficher le texte d’entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur. Pour plus d’informations, consultez Sécurisation des contrôles standard, Procédure : protéger contre les attaques de script dans une application web en appliquant l’encodage HTML aux chaînes et Validation des entrées utilisateur dans pages Web ASP.NET.

Constructeurs

HyperLinkColumn()

Initialise une nouvelle instance de la classe HyperLinkColumn.

Propriétés

DataNavigateUrlField	Obtient ou définit le champ issu de la source de données à lier à l'URL des liens hypertexte dans HyperLinkColumn.
DataNavigateUrlFormatString	Obtient ou définit le format d'affichage de l'URL des liens hypertexte dans HyperLinkColumn lorsque l'URL est liée aux données d'un champ situé dans une source de données.
DataTextField	Obtient ou définit le champ issu de la source de données à lier à la légende de texte des liens hypertexte dans HyperLinkColumn.
DataTextFormatString	Obtient ou définit le format d'affichage de la légende de texte des liens hypertexte dans la colonne HyperLinkColumn.
DesignMode	Obtient une valeur indiquant si la colonne est en mode design. (Hérité de DataGridColumn)
FooterStyle	Obtient les propriétés de style pour la section de pied de page de la colonne. (Hérité de DataGridColumn)
FooterText	Obtient ou définit le texte affiché dans la section de pied de page de la colonne. (Hérité de DataGridColumn)
HeaderImageUrl	Obtient ou définit l'emplacement d'une image à afficher dans la section d'en-tête de la colonne. (Hérité de DataGridColumn)
HeaderStyle	Obtient les propriétés de style pour la section d'en-tête de la colonne. (Hérité de DataGridColumn)
HeaderText	Obtient ou définit le texte affiché dans la section d'en-tête de la colonne. (Hérité de DataGridColumn)
IsTrackingViewState	Obtient une valeur qui détermine si l'objet DataGridColumn est marqué pour enregistrer son état. (Hérité de DataGridColumn)
ItemStyle	Obtient les propriétés de style pour les cellules d'éléments de la colonne. (Hérité de DataGridColumn)
NavigateUrl	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.
Owner	Obtient le contrôle DataGrid dont la colonne est membre. (Hérité de DataGridColumn)
SortExpression	Obtient ou définit le nom du champ ou de l'expression à passer à la méthode OnSortCommand(DataGridSortCommandEventArgs) lorsqu'une colonne est sélectionnée pour être triée. (Hérité de DataGridColumn)
Target	Obtient ou définit la fenêtre ou le frame cible pour afficher le contenu de la page Web vers laquelle pointe le lien hypertexte sélectionné par un clic dans la colonne.
Text	Obtient ou définit la légende de texte accompagnant les liens hypertexte de la colonne.
ViewState	Obtient l'objet StateBag qui permet à une colonne dérivée de la classe DataGridColumn de stocker ses propriétés. (Hérité de DataGridColumn)
Visible	Obtient ou définit une valeur qui indique si la colonne est visible dans le contrôle DataGrid. (Hérité de DataGridColumn)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FormatDataNavigateUrlValue(Object)	Met en forme une URL liée aux données, à l'aide du format spécifié par la propriété DataNavigateUrlFormatString.
FormatDataTextValue(Object)	Met en forme une légende de texte liée aux données, à l'aide du format spécifié par la propriété DataTextFormatString.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Initialize()	Fournit l’implémentation de base pour réinitialiser à son état initial une colonne dérivée de la classe DataGridColumn.
InitializeCell(TableCell, Int32, ListItemType)	Initialise la cellule représentant cette colonne avec le lien hypertexte contenu.
LoadViewState(Object)	Charge l'état de l'objet DataGridColumn. (Hérité de DataGridColumn)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnColumnChanged()	Appelle la méthode OnColumnsChanged(). (Hérité de DataGridColumn)
SaveViewState()	Enregistre l'état actuel de l'objet DataGridColumn. (Hérité de DataGridColumn)
ToString()	Retourne la représentation sous forme de chaîne de la colonne. (Hérité de DataGridColumn)
TrackViewState()	Provoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. (Hérité de DataGridColumn)

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState	Obtient une valeur qui indique si la colonne suit les changements de l'état d'affichage. (Hérité de DataGridColumn)
IStateManager.LoadViewState(Object)	Charge l'état enregistré précédemment. (Hérité de DataGridColumn)
IStateManager.SaveViewState()	Retourne un objet contenant les modifications de l'état. (Hérité de DataGridColumn)
IStateManager.TrackViewState()	Commence à suivre les modifications d'état. (Hérité de DataGridColumn)

S’applique à

HyperLinkColumn Classe

Définition

Exemples

Remarques

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

Commentaires

Ressources supplémentaires