ButtonColumn.DataTextFormatString-Eigenschaft

Artikel
08/20/2007

Ruft die Zeichenfolge ab, die das Anzeigeformat der Beschriftung für jede Schaltfläche angibt, oder legt diese fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property DataTextFormatString As String
'Usage
Dim instance As ButtonColumn
Dim value As String

value = instance.DataTextFormatString

instance.DataTextFormatString = value

public virtual string DataTextFormatString { get; set; }

public:
virtual property String^ DataTextFormatString {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DataTextFormatString ()

/** @property */
public void set_DataTextFormatString (String value)

public function get DataTextFormatString () : String

public function set DataTextFormatString (value : String)

Eigenschaftenwert

Die Zeichenfolge, die das Anzeigeformat der Beschriftung für jede Schaltfläche angibt. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Mit der DataTextFormatString-Eigenschaft kann ein benutzerdefiniertes Anzeigeformat für die Beschriftung der Schaltflächen im ButtonColumn-Objekt bereitgestellt werden.

Die Zeichenfolge für das Datenformat besteht aus zwei durch Doppelpunkt getrennten Teilen der Form {A:Bxx}. Die Formatzeichenfolge {0:F2} formatiert die Zelle z. B. so, dass eine Festkommazahl mit zwei Dezimalstellen angezeigt wird.

Hinweis

Die gesamte Zeichenfolge muss in geschweiften Klammern stehen, die darauf hinweisen, dass es sich nicht um ein Zeichenfolgenliteral, sondern um eine Formatzeichenfolge handelt. Text, der sich nicht in den geschweiften Klammern befindet, wird stets als Literaltext angezeigt.

Der Wert vor dem Doppelpunkt (im Beispiel A) gibt den Parameterindex in einer nullbasierten Parameterliste an.

Hinweis

Dieser Wert kann nur auf 0 (null) festgelegt werden, da in jeder Zelle nur ein Wert vorhanden ist.

Das Zeichen nach dem Doppelpunkt (im Beispiel B) gibt das Format an, in dem der Wert angezeigt wird. In der folgenden Tabelle sind die gebräuchlichen Formate aufgeführt.

Formatzeichen	Anzeige numerischer Werte in
C	Währungsformat.
D	Dezimales Format.
E	Wissenschaftliches Format (Exponentialformat).
F	Festes Format.
G	Allgemeines Format.
N	Zahlenformat.
X	Hexadezimales Format.

Hinweis

Mit Ausnahme von X, bei dem die hexadezimalen Zeichen in der vorliegenden Schreibweise angezeigt werden, wird die Groß- und Kleinschreibung bei den Formatierungszeichen nicht berücksichtigt.

Der Wert nach dem Formatierungszeichen (in dem allgemeinen Beispiel xx) gibt die Anzahl der signifikanten Ziffern oder Dezimalstellen an, die angezeigt werden sollen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Weitere Informationen über Formatzeichenfolgen finden Sie unter Übersicht über Formatierung.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der DataTextFormatString-Eigenschaft die Beschriftung der einzelnen Schaltflächen im ButtonColumn-Objekt im Währungsformat angezeigt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <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>
<body>
 
   <form 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="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <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>
 
<body>
 
   <form 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="JScript" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <script language="JScript" runat="server">
 
      function CreateDataSource() : ICollection
      {
         var dt : DataTable = new DataTable();
         var dr : DataRow;
 
         dt.Columns.Add(new DataColumn("IntegerValue", Int32));
         dt.Columns.Add(new DataColumn("StringValue", System.String));
         dt.Columns.Add(new DataColumn("CurrencyValue", double));
 
         for (var i : int = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr["IntegerValue"] = i;
            dr["StringValue"] = "Item " + i.ToString();
            dr["CurrencyValue"] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         var dv : DataView = new DataView(dt);
         return dv;
      }
 
      function Page_Load(sender, e : EventArgs) 
      {
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
      function Grid_CartCommand(sender, e : 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 + ".";        
 
      }
 
   </script>
 
<body>
 
   <form 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>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ButtonColumn-Klasse
ButtonColumn-Member
System.Web.UI.WebControls-Namespace
String.Empty

Weitere Ressourcen

Übersicht über Formatierung

Freigeben über

ButtonColumn.DataTextFormatString-Eigenschaft

Syntax

Eigenschaftenwert

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen