Partager via


HyperLinkField Classe

Définition

Représente un champ affiché sous forme de lien hypertexte dans un contrôle lié aux données.

public ref class HyperLinkField : System::Web::UI::WebControls::DataControlField
public class HyperLinkField : System.Web.UI.WebControls.DataControlField
type HyperLinkField = class
    inherit DataControlField
Public Class HyperLinkField
Inherits DataControlField
Héritage
HyperLinkField

Exemples

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


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

<%@ Page language="VB" %>

<!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 à des HyperLinkField champs dans une source de données. Les propriétés et DataNavigateUrlFields les DataTextField champs sont utilisés pour spécifier les champs à lier à la légende et à l’URL de navigation, respectivement, de chaque lien hypertexte affiché dans l’objetHyperLinkField.


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

<%@ Page language="VB" %>

<!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 DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString 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>

Remarques

La HyperLinkField classe est utilisée par les contrôles liés aux données (tels que 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’objet HyperLinkField s’affiche différemment en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle affiche un HyperLinkField objet sous forme de colonne, tandis que le contrôle l’affiche DetailsView sous forme de ligne.

Pour spécifier la légende à afficher pour les liens hypertexte, utilisez la Text propriété. Utilisez la NavigateUrl propriété pour spécifier l’URL à laquelle accéder lorsqu’un lien hypertexte est cliqué. Si vous souhaitez afficher le contenu lié dans une fenêtre ou un cadre spécifique, définissez la Target propriété.

Notes

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

Vous pouvez également lier l’objet HyperLinkField à des 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 en sorte que chaque lien hypertexte accède à un autre emplacement. Pour lier un champ à une légende, définissez la DataTextField propriété. Pour créer une URL pour la navigation, définissez la DataNavigateUrlFields propriété sur une liste de champs séparées par des virgules à utiliser pour créer l’URL.

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

Vous pouvez masquer un HyperLinkField objet dans un contrôle lié aux données en définissant la propriété falsesur Visible .

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

Notes

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement la section d’en-tête entière du contrôle. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété pour un champ lié individuel. 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é du ShowHeader contrôle (le cas échéant).

Vous pouvez également personnaliser l’apparence de l’objet HyperLinkField (couleur de police, couleur d’arrière-plan, et ainsi de suite) en définissant les propriétés de style pour les différentes parties du champ. Le tableau suivant répertorie les différentes propriétés de style.

Style, propriété Description
ControlStyle Paramètres de style pour les contrôles serveur Web enfants de l’objet HyperLinkField .
FooterStyle Paramètres de style pour la section 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 .

Constructeurs

HyperLinkField()

Initialise une nouvelle instance de la classe HyperLinkField.

Propriétés

AccessibleHeaderText

Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles.

(Hérité de DataControlField)
Control

Obtient une référence au contrôle de données auquel l'objet DataControlField est associé.

(Hérité de DataControlField)
ControlStyle

Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField.

(Hérité de DataControlField)
DataNavigateUrlFields

Obtient ou définit les noms des champs de la source de données utilisée pour construire les URL des liens hypertexte dans l'objet HyperLinkField.

DataNavigateUrlFormatString

Obtient ou définit la chaîne qui spécifie le format dans lequel les URL des liens hypertexte d'un objet HyperLinkField sont restituées.

DataTextField

Obtient ou définit le nom du champ de la source de données qui contient le texte à afficher pour les légendes des liens hypertexte de l'objet HyperLinkField.

DataTextFormatString

Obtient ou définit la chaîne qui spécifie le format d'affichage des légendes des liens hypertexte d'un objet HyperLinkField.

DesignMode

Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.

(Hérité de DataControlField)
FooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.

(Hérité de DataControlField)
FooterText

Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderImageUrl

Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données.

(Hérité de DataControlField)
HeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.

(Hérité de DataControlField)
HeaderText

Obtient ou définit le texte affiché dans l'élément d'en-tête d'un champ de contrôle de données.

(Hérité de DataControlField)
InsertVisible

Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion.

(Hérité de DataControlField)
IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
ItemStyle

Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données.

(Hérité de DataControlField)
NavigateUrl

Obtient ou définit l'URL à laquelle accéder lors d'un clic sur un lien hypertexte dans un objet HyperLinkField.

ShowHeader

Obtient ou définit une valeur indiquant si l'élément d'en-tête d'un champ de contrôle de données est restitué.

(Hérité de DataControlField)
SortExpression

Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier des données.

(Hérité de DataControlField)
Target

Obtient ou définit la fenêtre ou le frame cible dans lequel afficher la page Web vers laquelle un lien est établi lorsqu'un clic est effectué sur un lien hypertexte dans un objet HyperLinkField.

Text

Obtient ou définit le texte à afficher pour chaque lien hypertexte de l'objet HyperLinkField.

ValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.

(Hérité de DataControlField)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page.

(Hérité de DataControlField)
Visible

Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué.

(Hérité de DataControlField)

Méthodes

CloneField()

Crée une copie de l'objet dérivé de DataControlField en cours.

(Hérité de DataControlField)
CopyProperties(DataControlField)

Copie les propriétés de l'objet HyperLinkField actuel dans l'objet spécifié.

CreateField()

Retourne une nouvelle instance de la classe HyperLinkField.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrait la valeur du champ de contrôle de données à partir de la cellule active du tableau et ajoute la valeur à la collection IDictionary spécifiée.

(Hérité de DataControlField)
FormatDataNavigateUrlValue(Object[])

Met en forme l'URL de navigation à l'aide de la chaîne de mise en forme spécifiée par la propriété DataNavigateUrlFormatString.

FormatDataTextValue(Object)

Met en forme le texte de la légende à l'aide de la chaîne de mise en forme spécifiée 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(Boolean, Control)

Initialise l'objet HyperLinkField.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialise une cellule dans un HyperLinkField.

LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.

(Hérité de DataControlField)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnFieldChanged()

Déclenche l’événement FieldChanged.

(Hérité de DataControlField)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
ToString()

Retourne une chaîne qui représente cet objet DataControlField.

(Hérité de DataControlField)
TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)
ValidateSupportsCallback()

Indique que les contrôles contenus par l'objet HyperLinkField prend en charge les rappels.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtient ou définit le schéma associé à cet objet DataControlField.

(Hérité de DataControlField)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.

(Hérité de DataControlField)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données.

(Hérité de DataControlField)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.

(Hérité de DataControlField)
IStateManager.TrackViewState()

Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page.

(Hérité de DataControlField)

S’applique à

Voir aussi