ButtonField.DataTextFormatString 屬性

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得或設定字串，指定欄位值的顯示格式。

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

屬性值

String

格式字串，指定欄位值的顯示格式。預設為空字串 ("")，表示未將特殊格式套用至該欄位值。

範例

下列程式碼範例示範如何使用 DataTextFormatString 屬性來指定欄位值的自訂顯示格式。


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

備註

DataTextFormatString使用屬性可指定物件中所 ButtonField 顯示值的自訂顯示格式。 DataTextFormatString如果未設定屬性，則會顯示欄位的值，而不會有任何特殊格式設定。

注意

只有在設定屬性時， DataTextField 才會套用格式字串。

格式字串可以是任何常值字串，通常包含欄位值的預留位置。例如，在格式字串 "Item Value: {0}" 中 {0} ，預留位置會在物件中 ButtonField 顯示時，以欄位的值取代。格式字串的其餘部分會顯示為常值文字。

注意

如果格式字串不包含預留位置，則資料來源中的欄位值不會包含在最終顯示文字中。

預留位置包含兩個部分，以冒號分隔，並以大括弧括住，格式為 { A ： Bxx }。在一般範例 (A 冒號之前的值，) 指定以零起始的參數清單中的域值索引。

注意

此參數 A 是格式化語法的一部分。因為每個儲存格中只有一個域值，所以這個值只能設定為 0。

冒號和冒號之後的值是選擇性的。在一般範例中，冒號之後的字元 (B) 會指定要顯示值的格式。下表列出常見的格式。

格式化字元	說明
`C`	以貨幣格式顯示數值。
`D`	以十進位格式顯示數值。
`E`	以科學 (指數) 格式顯示數值。
`F`	以固定格式顯示數值。
`G`	以一般格式顯示數值。
`N`	以數位格式顯示數值。
`X`	以十六進位格式顯示數值。

注意

除了之外 X ，格式字元不會區分大小寫。格式 X 字元會在指定的案例中顯示十六進位字元。

在一般範例中，格式字元 (xx 後的值) 會指定要顯示的有效位數或小數位數。例如，格式字串 "{0:F2}" 會顯示具有兩個小數位數的固定點數。

如需格式化字串的詳細資訊，請參閱格式化類型。

這個屬性的值會儲存在檢視狀態中。

適用於

另請參閱

在 .NET 中將類型格式化

共用方式為

ButtonField.DataTextFormatString 屬性

定義

屬性值

範例

備註

適用於

另請參閱

其他資源