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

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

.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

public virtual bool ShowInsertButton { get;
 set; }

C++

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

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

メモ

データバインドコントロールをデータソースコントロール (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>

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

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

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

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

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

CommandField.ShowInsertButton プロパティ

「CommandField.ShowInsertButton プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

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

CommandField.ShowInsertButton プロパティ

急上昇のことば

「CommandField.ShowInsertButton プロパティ」の関連用語

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