ButtonField.DataTextFormatString Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger strängen som anger visningsformatet för fältets värde.

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

Egenskapsvärde

String

En formatsträng som anger visningsformatet för fältets värde. Standardvärdet är en tom sträng (""), som anger att ingen särskild formatering tillämpas på fältvärdet.

Exempel

I följande kodexempel visas hur du använder DataTextFormatString egenskapen för att ange ett anpassat visningsformat för värdena i ett fält.


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

Kommentarer

Använd egenskapen DataTextFormatString för att ange ett anpassat visningsformat för de värden som visas i ButtonField objektet. Om egenskapen DataTextFormatString inte har angetts visas värdet för fältet utan någon särskild formatering.

Note

Formatsträngen tillämpas endast när egenskapen DataTextField har angetts.

Formatsträngen kan vara valfri literalsträng och innehåller vanligtvis en platshållare för värdet för fältet. I formatsträngen "Item Value: {0}"{0} ersätts platshållaren till exempel med värdet för fältet när det visas i ButtonField objektet. Resten av formatsträngen visas som literaltext.

Note

Om formatsträngen inte innehåller någon platshållare inkluderas inte värdet för fältet från datakällan i den slutliga visningstexten.

Platshållaren består av två delar, avgränsade med ett kolon och inslagna i klammerparenteser, i formatet { A : Bxx }. Värdet före kolonet (A i det allmänna exemplet) anger indexet för fältvärdet i en nollbaserad lista med parametrar.

Note

Den här A parametern är en del av formateringssyntaxen. Eftersom det bara finns ett fältvärde i varje cell kan det här värdet bara anges till 0.

Kolonet och värdena efter kolonet är valfria. Tecknet efter kolonet (B i det allmänna exemplet) anger i vilket format värdet ska visas. I följande tabell visas de vanliga formaten.

Formattecken Description
C Visar numeriska värden i valutaformat.
D Visar numeriska värden i decimalformat.
E Visar numeriska värden i vetenskapligt (exponentiellt) format.
F Visar numeriska värden i fast format.
G Visar numeriska värden i allmänt format.
N Visar numeriska värden i talformat.
X Visar numeriska värden i hexadecimalt format.

Note

XFörutom är formattecken inte skiftlägeskänsliga. Formattecknet X visar hexadecimala tecken i det angivna fallet.

Värdet efter formattecknet (xx i det allmänna exemplet) anger antalet signifikanta siffror eller decimaler som ska visas. Formatsträngen "{0:F2}" visar till exempel ett fast punktnummer med två decimaler.

Mer information om formateringssträngar finns i Formateringstyper.

Värdet för den här egenskapen lagras i visningstillstånd.

Gäller för

Se även