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

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

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

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

ButtonField.DataTextField プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ButtonField オブジェクトが表示する Button コントロールの Text プロパティにバインドされている値のデータフィールド名を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 DataTextField As String

Visual Basic (使用法)

Dim instance As ButtonField
Dim value As String

value = instance.DataTextField

instance.DataTextField = value

public virtual string DataTextField { get;
 set; }

C++

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

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

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

JScript

public function get DataTextField
 () : String

public function set DataTextField
 (value : String)

プロパティ値
ButtonField にバインドするフィールドの名前。既定値は空の文字列 ("") です。この値は DataTextField プロパティが設定されていないことを示します。

解説

ButtonField オブジェクトの ButtonType プロパティに Button 値または Link 値を設定すると、DataTextField プロパティを使用して、ButtonField オブジェクトにバインドするフィールドの名前を指定できます。フィールドの値はボタンのテキストとして ButtonField オブジェクトに表示されます。また、オプションの DataTextFormatString プロパティを設定すると、表示されるテキストの書式を指定できます。

DataTextField プロパティを使用して ButtonField オブジェクトをデータソースのフィールドにバインドする代わりに、Text プロパティを使用して ButtonField オブジェクトのボタンに静的テキストを表示できます。Text プロパティを使用すると、各ボタンは同じキャプションを共有します。

メモ
DataTextField プロパティと Text プロパティの両方が設定されている場合は、DataTextField プロパティが優先されます。

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

使用例

次のコード例では、DataTextField プロパティを使用して、GridView コントロールの ButtonField 列に表示するフィールドを指定する方法を示します。

Visual Basic

<%@ Page language="VB" %>

<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>
  <body>
    <form runat="server">
        
      <h3>ButtonField DataTextField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                    
      <!-- 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="C#" %>

<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>
  <body>
    <form runat="server">
        
      <h3>ButtonField DataTextField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                    
      <!-- 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>

プラットフォーム

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

参照

関連項目
ButtonField クラス
ButtonField メンバ
System.Web.UI.WebControls 名前空間
DataTextFormatString
Text

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

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

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

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

ButtonField.DataTextField プロパティ

「ButtonField.DataTextField プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

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

ButtonField.DataTextField プロパティ

急上昇のことば

「ButtonField.DataTextField プロパティ」の関連用語

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