ButtonColumn.DataTextFormatString Свойство

Определение

Получает или задает строку, определяющую формат отображения заголовка для каждой кнопки.Gets or sets the string that specifies the display format for the caption in each button.

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

Значение свойства

Строка, определяющая формат отображения заголовка для каждой кнопки.The string that specifies the display format for the caption in each button. Значение по умолчанию — пустая строка ("").The default is an empty string ("").

Примеры

В следующем примере кода показано, как использовать свойство DataTextFormatString для отображения заголовка каждой кнопки в ButtonColumnном объекте в формате валюты.The following code example demonstrates how to use the DataTextFormatString property to display the caption of each button in the ButtonColumn object in currency format.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="c#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
      void Grid_CartCommand(Object sender, DataGridCommandEventArgs e) 
      {
         
         // e.Item is the table row where the command is raised.
         // For bound columns, the value is stored in the Text property of the TableCell.
         Label1.Text = "You selected: " + e.Item.Cells[0].Text + ".";        
 
      }
 
   </script>
 
<head runat="server">
    <title>ButtonColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>ButtonColumn Example</h3>
 
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           OnItemCommand="Grid_CartCommand"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>
 
         <Columns>
 
            <asp:BoundColumn 
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:ButtonColumn 
                 HeaderText="Price" 
                 ButtonType="PushButton" 
                 DataTextField="CurrencyValue"
                 DataTextFormatString="{0:C}"
                 CommandName="AddToCart" /> 

         </Columns>

      </asp:DataGrid>

      <br /><br />

      <asp:Label id="Label1" runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="vb" runat="server">
        Function CreateDataSource() As ICollection
            Dim dt As New DataTable()
            Dim dr As DataRow
            
            dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
            dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
            dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
            
            Dim i As Integer
            For i = 0 To 8
                dr = dt.NewRow()
                dr(0) = i
                dr(1) = "Item " + i.ToString()
                dr(2) = 1.23 *(i + 1)
                dt.Rows.Add(dr)
            Next i
            
            Dim dv As New DataView(dt)
            CreateDataSource = dv
        End Function 'CreateDataSource


        Sub Page_Load(sender As Object, e As EventArgs)
            If Not IsPostBack Then
                ' Load this data only once.
                ItemsGrid.DataSource = CreateDataSource()
                ItemsGrid.DataBind()
            End If
        End Sub 'Page_Load


        Sub Grid_CartCommand(sender As Object, e As DataGridCommandEventArgs)
            
            ' e.Item is the table row where the command is raised.
            ' For bound columns, the value is stored in the Text property of the TableCell.
            Label1.Text = "You selected: " + e.Item.Cells(0).Text + "."
        End Sub 'Grid_CartCommand 
   </script>
<head runat="server">
    <title>ButtonColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>ButtonColumn Example</h3>
 
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           OnItemCommand="Grid_CartCommand"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>
 
         <Columns>
 
            <asp:BoundColumn 
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:ButtonColumn 
                 HeaderText="Price" 
                 ButtonType="PushButton" 
                 DataTextField="CurrencyValue"
                 DataTextFormatString="{0:C}"
                 CommandName="AddToCart" /> 

         </Columns>

      </asp:DataGrid>

      <br /><br />

      <asp:Label id="Label1" runat="server"/>
 
   </form>
 
</body>
</html>

Комментарии

Используйте свойство DataTextFormatString, чтобы задать пользовательский формат вывода заголовка кнопок в ButtonColumn объекте.Use the DataTextFormatString property to provide a custom display format for the caption of the buttons in the ButtonColumn object.

Строка формата данных состоит из двух частей, разделенных двоеточием, в форме {A:Bxx}.The data format string consists of two parts, separated by a colon, in the form {A:Bxx}. Например, строка форматирования {0:F2} форматирует ячейку для вывода числа с фиксированной точкой с двумя десятичными разрядами.For example, the formatting string {0:F2} formats the cell to display a fixed point number with two decimal places.

Примечание

Вся строка должна быть заключена в фигурные скобки, чтобы указать, что это строка формата, а не литеральная строка.The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Любой текст за пределами фигурных скобок отображается как литеральный текст.Any text outside the braces is displayed as literal text.

Значение перед двоеточием (A в общем примере) указывает индекс параметра в списке параметров (с отсчетом от нуля).The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.

Примечание

Это значение может быть задано только равным 0, поскольку в каждой ячейке содержится только одно значение.This value can be set only to 0 because there is only one value in each cell.

Символ после двоеточия (B в общем примере) задает формат для вывода значения в.The character after the colon (B in the general example) specifies the format to display the value in. В следующей таблице перечислены общие форматы.The following table lists the common formats.

Символ форматаFormat character Отображает числовые значения вDisplays numeric values in
C Формат валюты.Currency format.
D Десятичный формат.Decimal format.
E Экспоненциальный (экспоненциальный) формат.Scientific (exponential) format.
F Фиксированный формат.Fixed format.
G Общий формат.General format.
N Числовой формат.Number format.
X Шестнадцатеричный формат.Hexadecimal format.

Примечание

Символ формата не учитывает регистр, за исключением X, в котором отображаются шестнадцатеричные символы в указанном варианте.The format character is not case sensitive, except for X, which displays the hexadecimal characters in the case specified.

Значение после символа формата (xx в общем примере) указывает количество значащих цифр или десятичных разрядов для вывода.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

Значение этого свойства хранится в состоянии представления.The value of this property is stored in view state.

Дополнительные сведения о форматировании строк см. в статье Общие сведения о форматировании.For more information on formatting strings, see Formatting Types.

Применяется к

Дополнительно