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

HyperLinkField, classe

Mise à jour : novembre 2007

Représente un champ qui s'affiche en tant que lien hypertexte dans un contrôle lié aux données.

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

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class HyperLinkField : DataControlField
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class HyperLinkField extends DataControlField
public class HyperLinkField extends DataControlField

La classe HyperLinkField est utilisée par les contrôles liés aux données (par exemple GridView et DetailsView) pour afficher un lien hypertexte pour chaque enregistrement affiché. Lorsque l'utilisateur clique sur un lien hypertexte, il est dirigé vers la page Web associée au lien hypertexte. L'affichage de l'objet HyperLinkField varie en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le contrôle GridView affiche un objet HyperLinkField comme une colonne, tandis que le contrôle DetailsView l'affiche comme une ligne.

Pour spécifier la légende à afficher pour les liens hypertexte, utilisez la propriété Text. Utilisez la propriété NavigateUrl pour spécifier l'URL à atteindre lorsqu'un clic a été effectué sur un lien hypertexte. Si vous souhaitez afficher le contenu lié dans une fenêtre ou un frame spécifique, définissez la propriété Target.

Remarque :

Lorsque les propriétés Text et NavigateUrl sont définies, tous les liens hypertexte de l'objet HyperLinkField partagent les mêmes légende et URL de navigation. De même, la propriété Target s'applique également à tous les liens hypertexte.

Vous pouvez également lier l'objet HyperLinkField aux champs d'une source de données. Cela vous permet d'afficher une légende différente pour chaque lien hypertexte dans l'objet HyperLinkField et de faire naviguer chaque lien hypertexte jusqu'à un emplacement différent. Pour lier un champ à une légende, définissez la propriété DataTextField. Pour créer une URL pour la navigation, attribuez une liste de champs séparés par des virgules à la propriété DataNavigateUrlFields pour créer l'URL.

Vous pouvez spécifier un format personnalisé pour les légendes et les URL de navigation en définissant les propriétés DataTextFormatString et DataNavigateUrlFormatString.

Vous pouvez masquer un objet HyperLinkField dans un contrôle lié aux données en attribuant à la propriété Visible la valeur false.

Vous pouvez personnaliser les sections d'en-tête et de pied de page d'un objet HyperLinkField. Pour afficher une légende dans la section d'en-tête ou de pied de page, définissez les propriétés HeaderText ou FooterText, respectivement. Pour afficher une image dans la section d'en-tête au lieu du texte, définissez la propriété HeaderImageUrl. La section d'en-tête peut être masquée dans l'objet HyperLinkField en affectant la valeur false à la propriété ShowHeader.

Remarque :

Certains contrôles liés aux données (tels que le contrôle GridView) peuvent afficher ou masquer entièrement la section d'en-tête du contrôle. Ces contrôles liés aux données ne prennent pas en charge la propriété ShowHeader pour un champ individuel lié aux données. Pour afficher ou masquer l'intégralité de la section d'en-tête d'un contrôle lié aux données, utilisez la propriété ShowHeader du contrôle (le cas échéant).

Vous pouvez également personnaliser l'apparence de l'objet HyperLinkField (couleur de police, couleur d'arrière-plan, etc.) en définissant les propriétés de style des différentes parties du champ. Le tableau suivant énumère les différentes propriétés de style.

Propriété de style

Description

ControlStyle

Paramètres de style des contrôles serveur Web enfants de l'objet HyperLinkField.

FooterStyle

Paramètres de style pour la section de pied de page de l'objet HyperLinkField.

HeaderStyle

Paramètres de style pour la section d'en-tête de l'objet HyperLinkField.

ItemStyle

Paramètres de style pour les éléments de données de l'objet HyperLinkField.

L'exemple de code suivant montre comment utiliser un objet HyperLinkField pour afficher une colonne de liens hypertexte statiques dans un contrôle GridView. Chaque lien hypertexte de l'objet HyperLinkField partage les mêmes légende et URL de navigation spécifiées par les propriétés Text et NavigateUrl, respectivement.


<%@ 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 runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>HyperLinkField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">

        <columns>

          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />

        </columns>

      </asp:gridview>

      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>

    </form>
  </body>
</html>



L'exemple de code suivant montre comment lier un objet HyperLinkField aux champs d'une source de données. Les propriétés DataTextField et DataNavigateUrlFields sont utilisées pour spécifier les champs pour créer une liaison avec la légende et l'URL de navigation, respectivement, de chaque lien hypertexte affiché dans l'objet HyperLinkField.


<%@ 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 runat="server">
    <title>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>HyperLinkField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- The UnitPrice field values are bound to the         -->
      <!-- captions of the hyperlinks in the HyperLinkField    -->
      <!-- field column, formatted as currency. The ProductID  -->
      <!-- field values are bound to the navigate URLs of the  -->
      <!-- hyperlinks. However, instead of being the actual    -->
      <!-- URL values, the product ID is passed to the linked  -->
      <!-- page as a parameter in the URL specified by the     -->
      <!-- DataNavigateUrlFormatString property.               -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">

        <columns>

          <asp:boundfield datafield="OrderID" 
            headertext="Order ID"/>
          <asp:boundfield datafield="ProductID" 
            headertext="Product ID"/>
          <asp:hyperlinkfield datatextfield="UnitPrice"
            datatextformatstring="{0:c}"
            datanavigateurlfields="ProductID"
            datanavigateurlformatstring="~\details.aspx?ProductID={0}"          
            headertext="Price"
            target="_blank" />
          <asp:boundfield datafield="Quantity" 
            headertext="Quantity"/>

        </columns>

      </asp:gridview>

      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>

    </form>
  </body>
</html>



System.Object
  System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.HyperLinkField

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

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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: