CommandField.ShowEditButton プロパティ

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

CommandField.ShowEditButton プロパティ

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

CommandField フィールドに Edit ボタンが表示されるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 ShowEditButton As Boolean

Visual Basic (使用法)

Dim instance As CommandField
Dim value As Boolean

value = instance.ShowEditButton

instance.ShowEditButton = value

C#

public virtual bool ShowEditButton { get;
 set; }

C++

public:
virtual property bool ShowEditButton {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_ShowEditButton ()

/** @property */
public void set_ShowEditButton (boolean value)

JScript

public function get ShowEditButton
 () : boolean

public function set ShowEditButton
 (value : boolean)

プロパティ値
CommandField に Edit ボタンを表示する場合は true。それ以外の場合は false。既定値は false です。

解説

ShowEditButton プロパティを使用して、データ ソース コントロール内のそれぞれのレコードの CommandField フィールドに Edit ボタンを表示するかどうかを指定します。Edit ボタンを使用すると、レコードの値を編集できます。

ユーザーが Edit ボタンをクリックすると、レコード内のフィールドごとに入力コントロールが表示されます。レコードの Edit ボタンは Update ボタンと Cancel ボタンに置き換わり、レコードのその他のコマンド ボタンはすべて非表示になります。Update ボタンをクリックするとレコードがデータ ソースの新しい値で更新され、Cancel ボタンをクリックすると操作がキャンセルされます。

メモ
データ バインド コントロールをデータ ソース コントロール (SqlDataSource コントロールなど) と組み合わせて使用すると、データ バインド コントロールはデータ ソース コントロールの機能を利用して、自動更新機能を提供できます。その他のデータ ソースの場合、データ バインド コントロールの適切なイベント中に更新操作を実行するためにルーチンを提供する必要があります。

CommandField フィールドの ButtonType プロパティが ButtonType.Button または ButtonType.Link に設定されている場合は、EditText プロパティを使用して、Edit ボタンに表示するテキストを指定します。または、最初に ButtonType プロパティを ButtonType.Image に設定してから EditImageUrl プロパティを設定することにより、イメージを表示できます。

使用例

ShowEditButton プロパティを使用して、GridView コントロール内のそれぞれのレコードに Edit ボタンを表示する方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<html>
  <body>
    <form runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            buttontype="Image"
            editimageurl="~\Images\EditButton.jpg"
            cancelimageurl="~\Images\CancelButton.jpg"
            updateimageurl="~\Images\UpdateButton.jpg"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects
  -->
      <!-- to the Northwind sample database. Use an ASP.NET
     -->
      <!-- expression to retrieve the connection string
 value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"
  
        selectcommand="Select [CustomerID], [CompanyName], [Address],
 [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName,
 Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID
 = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

C#

<%@ Page language="C#" %>

<html>
  <body>
    <form runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            buttontype="Image"
            editimageurl="~\Images\EditButton.jpg"
            cancelimageurl="~\Images\CancelButton.jpg"
            updateimageurl="~\Images\UpdateButton.jpg"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value
   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City],
 [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address,
 City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        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

参照

関連項目
CommandField クラス
CommandField メンバ
System.Web.UI.WebControls 名前空間
CommandField.EditImageUrl プロパティ
CommandField.EditText プロパティ
CommandField.ShowCancelButton プロパティ
CommandField.ShowDeleteButton プロパティ
ShowInsertButton
ShowSelectButton
UpdateImageUrl
UpdateText