ButtonField.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 de la valeur du champ.

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 de mise en forme qui spécifie le format d'affichage de la valeur du champ. La valeur par défaut est une chaîne vide (""), qui indique qu'aucune mise en forme spéciale n'est appliquée à la valeur de champ.

Exemples

L’exemple de code suivant montre comment utiliser la DataTextFormatString propriété pour spécifier un format d’affichage personnalisé pour les valeurs d’un champ.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void AuthorsGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = AuthorsGridView.Rows[index];
      TableCell lastNameCell = selectedRow.Cells[1];
      string lastName = lastNameCell.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + lastName + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField DataTextField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField DataTextField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="AuthorsGridView"/>
                    
      <!-- Set the DataTextField property of the ButtonField -->
      <!-- declaratively. Set the DataTextFormatString       -->
      <!-- property to apply special formatting to the text. -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="AuthorsGridView_RowCommand" 
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Link" 
            commandname="Select"
            headertext="Select Author"
            datatextfield="au_lname"
            datatextformatstring="[{0}]"    
            text="Select"/>
          <asp:boundfield datafield="au_fname" 
            headertext="First Name"/>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors]"
        connectionstring="server=localhost;database=pubs;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">
<script runat="server">

  Sub AuthorsGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
    ' If multiple ButtonField column fields are used, use the
    ' CommandName property to determine which button was clicked.
    If e.CommandName = "Select" Then
    
      ' Convert the row index stored in the CommandArgument
      ' property to an Integer.
      Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
      ' Get the last name of the selected author from the appropriate
      ' cell in the GridView control.
      Dim selectedRow As GridViewRow = AuthorsGridView.Rows(index)
      Dim lastNameCell As TableCell = selectedRow.Cells(1)
      Dim lastName As String = lastNameCell.Text
    
      ' Display the selected author.
      Message.Text = "You selected " & lastName & "."
      
    End If
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField DataTextField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField DataTextField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="AuthorsGridView"/>
                    
      <!-- Set the DataTextField property of the ButtonField -->
      <!-- declaratively. Set the DataTextFormatString       -->
      <!-- property to apply special formatting to the text. -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="AuthorsGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Link" 
            commandname="Select"
            headertext="Select Author"
            datatextfield="au_lname"
            datatextformatstring="[{0}]"    
            text="Select"/>
          <asp:boundfield datafield="au_fname" 
            headertext="First Name"/>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname] FROM [authors]"
        connectionstring="server=localhost;database=pubs;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 valeurs affichées dans l’objet ButtonField . Si la DataTextFormatString propriété n’est pas définie, la valeur du champ s’affiche sans aucune 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 "Item Value: {0}"de format , l’espace {0} réservé est remplacé par la valeur du champ lorsqu’il est affiché dans l’objet ButtonField . Le reste de la chaîne de format s’affiche 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 signe deux-points et encapsulées dans des accolades, au format { 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 A 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 les 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

À l’exception de X, les caractères de format ne respectent pas la casse. Le X caractère de format affiche les caractères hexadécimaux dans le cas spécifié.

La valeur 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 "{0:F2}" de format affiche un nombre à point fixe avec deux décimales.

Pour plus d’informations sur la mise en forme des chaînes, consultez Mise en forme des types.

La valeur de cette propriété est stockée dans l’état d’affichage.

S’applique à

Voir aussi