HyperLinkColumn Classe

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 DataGrid contrôle qui contient un lien hypertexte pour chaque élément de 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.

Note

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"
                 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 dans le DataGrid. Définissez la Text propriété pour spécifier le texte de légende du lien hypertexte. Pour spécifier l’URL à lier lorsque le lien hypertexte est cliqué, définissez la NavigateUrl propriété.

Note

Si vous définissez les propriétés et NavigateUrl les Text propriétés, 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 de texte et l’URL des liens hypertexte dans le HyperLinkColumn champ d’une source de données au lieu de définir les propriétés et NavigateUrl les Text propriétés. Cela vous permet d’afficher une légende différente 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 pour établir une liaison à la légende de texte des liens hypertexte dans la colonne.

Note

Les DataTextField propriétés et Text les deux 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é.

Note

Les DataNavigateUrlField propriétés et NavigateUrl les deux 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é au moment où le lien hypertexte est cliqué.

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

Avertissement

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 l’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, Comment : protéger contre les attaques de script dans une application web en appliquant l’encodage HTML à des chaînes et en validant l’entrée utilisateur dans ASP.NET pages web.

Constructeurs

Nom	Description
HyperLinkColumn()	Initialise une nouvelle instance de la classe HyperLinkColumn.

Propriétés

Nom	Description
DataNavigateUrlField	Obtient ou définit le champ d’une source de données à lier à l’URL des liens hypertexte dans le HyperLinkColumn.
DataNavigateUrlFormatString	Obtient ou définit le format d’affichage de l’URL des liens hypertexte dans le HyperLinkColumn moment où l’URL est liée à un champ dans une source de données.
DataTextField	Obtient ou définit le champ d’une source de données à lier à la légende de texte des liens hypertexte dans le HyperLinkColumn.
DataTextFormatString	Obtient ou définit le format d’affichage de la légende de texte des liens hypertexte dans la HyperLinkColumn colonne.
DesignMode	Obtient une valeur qui indique si la colonne est en mode création. (Hérité de DataGridColumn)
FooterStyle	Obtient les propriétés de style de la section pied de page de la colonne. (Hérité de DataGridColumn)
FooterText	Obtient ou définit le texte affiché dans la section 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 de 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ément de la colonne. (Hérité de DataGridColumn)
NavigateUrl	Obtient ou définit l’URL à laquelle lier lorsqu’un lien hypertexte dans la colonne est cliqué.
Owner	Obtient le DataGrid contrôle dont la colonne est membre. (Hérité de DataGridColumn)
SortExpression	Obtient ou définit le nom du champ ou de l’expression à passer à la OnSortCommand(DataGridSortCommandEventArgs) méthode lorsqu’une colonne est sélectionnée pour le tri. (Hérité de DataGridColumn)
Target	Obtient ou définit la fenêtre ou le cadre cible pour afficher le contenu de la page Web lié au moment où le lien hypertexte de la colonne est cliqué.
Text	Obtient ou définit la légende de texte à afficher pour les liens hypertexte dans la colonne.
ViewState	Obtient l’objet StateBag qui permet à une colonne dérivée de la DataGridColumn classe 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 DataGrid contrôle. (Hérité de DataGridColumn)

Méthodes

Nom	Description
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 DataNavigateUrlFormatString propriété.
FormatDataTextValue(Object)	Met en forme une légende de texte liée aux données à l’aide du format spécifié par la DataTextFormatString propriété.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Initialize()	Fournit l’implémentation de base pour réinitialiser une colonne dérivée de la DataGridColumn classe à son état initial.
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 Objectactuel. (Hérité de Object)
OnColumnChanged()	Appelle la OnColumnsChanged() méthode. (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 d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. (Hérité de DataGridColumn)

Implémentations d’interfaces explicites

Nom	Description
IStateManager.IsTrackingViewState	Obtient une valeur qui indique si la colonne suit les modifications de l’état d’affichage. (Hérité de DataGridColumn)
IStateManager.LoadViewState(Object)	Charge l’état précédemment enregistré. (Hérité de DataGridColumn)
IStateManager.SaveViewState()	Retourne un objet contenant les modifications d’état. (Hérité de DataGridColumn)
IStateManager.TrackViewState()	Démarre le suivi des modifications d’état. (Hérité de DataGridColumn)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?

Partager via

HyperLinkColumn Classe

Définition

Exemples

Remarques

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

Commentaires