CommandField.ShowInsertButton プロパティ

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

CommandField.ShowInsertButton プロパティ

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

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

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

Visual Basic (宣言)

Public Overridable Property
 ShowInsertButton As Boolean

Visual Basic (使用法)

Dim instance As CommandField
Dim value As Boolean

value = instance.ShowInsertButton

instance.ShowInsertButton = value

C#

public virtual bool ShowInsertButton { get;
 set; }

C++

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

J#

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

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

JScript

public function get ShowInsertButton
 () : boolean

public function set ShowInsertButton
 (value : boolean)

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

解説

ShowInsertButton プロパティを使用して、CommandField フィールドに New ボタンを表示するかどうかを指定します。New ボタンは CommandField フィールドに 1 回だけ表示され、ユーザーはデータ ソースに新しいレコードを追加できます。

メモ
このプロパティは、DetailsView コントロールなど、挿入操作をサポートしたデータ バインド コントロールにのみ適用されます。

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

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

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

使用例

ShowInsertButton プロパティを使用して、DetailsView コントロールに New ボタンを表示し、ユーザーがデータ ソースに新しいレコードを追加できるようにする方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

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

      <asp:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">
        
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <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"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>
        
      </asp:detailsview>
            
      <!-- 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]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName],
 [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode,
 @Country)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

C#

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

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

      <asp:detailsview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneraterows="false"
        datakeynames="CustomerID"  
        allowpaging="true" 
        runat="server">
        
        <fields>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="CompanyName"/>
          <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"/>
          <asp:commandfield showinsertbutton="true"
            showheader="true"
            headertext="Add Customer"/>
        </fields>
        
      </asp:detailsview>
            
      <!-- 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]"
        insertcommand="Insert Into [Customers]([CustomerID], [CompanyName],
 [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode,
 @Country)"
        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.InsertImageUrl プロパティ
CommandField.InsertText プロパティ
CommandField.NewImageUrl プロパティ
CommandField.NewText プロパティ
CommandField.ShowCancelButton プロパティ
CommandField.ShowDeleteButton プロパティ
CommandField.ShowEditButton プロパティ
ShowSelectButton