ButtonColumn.DataTextFormatString プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ButtonColumn.DataTextFormatString プロパティ

各ボタンのキャプションの表示形式を指定する文字列を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 DataTextFormatString As String

Visual Basic (使用法)

Dim instance As ButtonColumn
Dim value As String

value = instance.DataTextFormatString

instance.DataTextFormatString = value

public virtual string DataTextFormatString
 { get; set; }

C++

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

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

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

JScript

public function get DataTextFormatString
 () : String

public function set DataTextFormatString
 (value : String)

プロパティ値
各ボタンのキャプションの表示形式を指定する文字列。既定値は空の文字列 ("") です。

解説

DataTextFormatString プロパティを使用して、ButtonColumn オブジェクトのボタンのキャプションにカスタムの表示形式を指定します。

データ書式指定文字列は、{A:Bxx} の書式で、コロンで区切られた 2 つの部分から構成されます。たとえば、書式指定文字列 {0:F2} を使用すると、2 桁の固定小数点数でセルが表示されます。

メモ
文字列の全体はリテラル文字列ではなく、書式指定文字列であることを示すために、中かっこ ({}) で囲む必要があります。かっこの外側のテキストはリテラルテキストとして表示されます。

コロンの前の値 (一般的な例での A) は 0 から始まるパラメータのリストのパラメータインデックスを指定します。

メモ
各セルには 1 つの値しかないため、この値は必ず 0 に設定します。

コロンの後の文字 (一般的な例での B) は値を表示する書式を指定します。共通の書式を次の表に示します。

書式指定文字	数値の表示形式
C	通貨書式
D	10 進形式
E	Scientific (指数) 形式
F	固定形式
G	一般形式
N	数値形式
X	16 進形式

メモ
書式指定文字では、X を除き大文字と小文字が区別されません。X は大文字または小文字を指定した 16 進数文字を表示します。

書式指定文字の後の値 (一般的な例での xx) は、表示する有効桁数または小数点を指定します。

このプロパティの値はビューステートに格納されます。

書式指定文字列の詳細については、「書式設定の概要」を参照してください。

使用例

DataTextFormatString プロパティを使用して、ButtonColumn オブジェクトの各ボタンのキャプションを通貨書式で表示する方法を次のコード例に示します。

Visual Basic

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

JScript

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ButtonColumn クラス
ButtonColumn メンバ
System.Web.UI.WebControls 名前空間
String.Empty
その他の技術情報
書式設定の概要

このページでは「.NET Framework クラスライブラリリファレンス」からButtonColumn.DataTextFormatString プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からButtonColumn.DataTextFormatString プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からButtonColumn.DataTextFormatString プロパティを検索

>> 「ButtonColumn.DataTextFormatString プロパティ」を含む用語の索引
ButtonColumn.DataTextFormatString プロパティのページへのリンク


	© 2025 Microsoft.All rights reserved.

ButtonColumn.DataTextFormatString プロパティとは？ わかりやすく解説

ButtonColumn.DataTextFormatString プロパティ

急上昇のことば

ButtonColumn.DataTextFormatString プロパティとは？わかりやすく解説