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

HyperLinkField.DataTextFormatString, propriété

Mise à jour : novembre 2007

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

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

public virtual string DataTextFormatString { get; set; }
/** @property */
public String get_DataTextFormatString()
/** @property */
public  void set_DataTextFormatString(String value)

public function get DataTextFormatString () : String
public function set DataTextFormatString (value : String)

Valeur de propriété

Type : System.String

Chaîne qui spécifie le format d'affichage des légendes des liens hypertexte de HyperLinkField. La valeur par défaut est une chaîne vide ("") qui indique qu'aucune mise en forme spéciale n'est appliquée aux légendes des liens hypertexte.

Utilisez la propriété DataTextFormatString pour spécifier un format d'affichage personnalisé pour les légendes affichées dans l'objet HyperLinkField. Si la propriété DataTextFormatString n'est pas définie, la valeur du champ est affichée sans mise en forme spéciale.

Remarque :

La chaîne de mise en forme est appliquée uniquement lorsque la propriété DataTextField est définie.

La chaîne de format peut être n'importe quelle chaîne littérale et inclut généralement un espace réservé pour la valeur du champ. Par exemple, dans la chaîne de mise en forme "Item Value: {0}", l'espace réservé "{0 }" est remplacé par la valeur du champ lorsqu'elle est affichée dans l'objet HyperLinkField. Le reste de la chaîne de format est affiché sous la forme de texte littéral.

Remarque :

Si la chaîne de format n'inclut pas d'espace réservé, la valeur du champ de la source de données n'est pas incluse dans le texte final affiché.

L'espace réservé est composé de deux parties séparées par le signe deux-points et figurant entre accolades, comme suit : {A:Bxx}. La valeur placée devant le signe deux-points (A dans l'exemple général) spécifie l'index de la valeur du champ dans une liste de paramètres de base zéro.

Remarque :

Ce paramètre fait partie de la syntaxe de mise en forme. Cette valeur ne peut être que 0, car il n'y a qu'une seule valeur de champ dans chaque cellule.

Le signe deux-points et les valeurs qui le suivent sont facultatifs. Le caractère placé après les deux-points (B dans l'exemple général) spécifie le format dans lequel la valeur doit être affichée. Le tableau suivant répertorie les formats courants.

Caractère de format

Description

C

Affiche les valeurs numériques au format monétaire.

D

Affiche les valeurs numériques au format décimal.

E

Affiche les valeurs numériques au format scientifique (exponentiel).

F

Affiche les valeurs numériques au format fixe.

G

Affiche les valeurs numériques au format général.

N

Affiche les valeurs numériques au format numérique.

X

Affiche les valeurs numériques au format hexadécimal.

Remarque :

Les caractères de format ne respectent pas la casse, à l'exception de X, qui affiche les caractères hexadécimaux dans la casse spécifiée.

La valeur placée après le caractère de format (xx dans l'exemple général) spécifie le nombre de chiffres significatifs ou de décimales à afficher. Par exemple, la chaîne de format "{0:F2}" affiche un nombre à virgule fixe avec deux décimales.

Pour plus d'informations sur les chaînes de mise en forme, consultez Vue d'ensemble des formats.

L'exemple de code suivant montre comment utiliser la propriété DataTextFormatString pour mettre en forme les valeurs liées aux légendes des liens hypertexte affichées dans un objet HyperLinkField. Les valeurs sont mises en forme comme monnaie.


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



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: