HyperLinkField.DataNavigateUrlFormatString 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 dans lequel les URL des liens hypertexte d'un objet HyperLinkField sont restituées.

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

Valeur de propriété

String

Une chaîne qui spécifie le format dans lequel les URL des liens hypertexte d'un HyperLinkField sont restituées. La valeur par défaut est une chaîne vide ("") qui indique qu'aucune mise en forme spéciale n'est appliquée aux valeurs d'URL.

Exemples

L’exemple de code suivant montre comment utiliser la DataNavigateUrlFormatString propriété pour spécifier un format personnalisé à appliquer aux URL de navigation des liens hypertexte affichés dans un HyperLinkField objet. La valeur du champ spécifié par la DataTextField propriété est passée en tant que chaîne de requête à une page Web spécifiée dans la chaîne de format.


<%@ 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 DataNavigateUrlFormatString propriété pour spécifier un format personnalisé pour les URL des liens hypertexte dans un HyperLinkField objet . Si la DataNavigateUrlFormatString propriété n’est pas définie, les URL des liens hypertexte n’obtiennent aucune mise en forme spéciale.

Notes

La chaîne de format est appliquée uniquement lorsque la DataNavigateUrlFields 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 « Valeur de l’élément : {0}», l’espace {0} réservé est remplacé par la valeur du champ 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