HyperLinkField, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

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)

public class HyperLinkField : DataControlField
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.

RemarqueRemarque

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.

RemarqueRemarque

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é du 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#" %>

<html>
  <body>
    <form 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#" %>

<html>
  <body>
    <form 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>


  • AspNetHostingPermission  pour utiliser un objet HyperLinkField dans un environnement hébergé. Valeur d'énumération associée : AspNetHostingPermissionLevel.Minimal.

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

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

Ajouts de la communauté

AJOUTER
Afficher: