HyperLinkField.DataTextFormatString Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Valeur de propriété

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.

Exemples

L’exemple de code suivant montre comment utiliser la DataTextFormatString propriété pour mettre en forme les valeurs liées aux légendes de lien hypertexte affichées dans un HyperLinkField objet . Les valeurs sont mises en forme en tant que devise.


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

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

Notes

La chaîne de format est appliquée uniquement lorsque la DataTextField propriété 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 format « Item Value: {0}», l’espace {0} réservé est remplacé par la valeur du champ lorsqu’il est affiché dans l’objet HyperLinkField . Le reste de la chaîne de format est affiché sous forme de texte littéral.

Notes

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 d’affichage final.

L’espace réservé se compose de deux parties, séparées par un deux-points et enveloppées d’accolades, sous la forme {A:Bxx}. La valeur avant les deux-points (A dans l’exemple général) spécifie l’index de la valeur de champ dans une liste de paramètres de base zéro.

Notes

Ce paramètre fait partie de la syntaxe de mise en forme. Étant donné qu’il n’y a qu’une seule valeur de champ dans chaque cellule, cette valeur ne peut être définie que sur 0.

Les deux-points et les valeurs après le signe deux-points sont facultatifs. Le caractère après les deux-points (B dans l’exemple général) spécifie le format dans lequel afficher la valeur. Le tableau suivant répertorie les formats courants.

Caractère de mise en forme 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.

Notes

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 après le caractère de mise en forme (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 la mise en forme des chaînes, consultez Mise en forme des types.

S’applique à

Voir aussi