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

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

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

CommandField.InsertText プロパティ

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

CommandField フィールドの Insert ボタンのキャプションを取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 InsertText As String

Visual Basic (使用法)

Dim instance As CommandField
Dim value As String

value = instance.InsertText

instance.InsertText = value

[LocalizableAttribute(true)] 
public virtual string InsertText { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property String^ InsertText {
    String^ get ();
    void set (String^ value);
}

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

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

JScript

public function get InsertText
 () : String

public function set InsertText
 (value : String)

プロパティ値
CommandField の Insert ボタンのキャプション。既定値は "挿入" です。

解説

CommandField フィールドの ButtonType プロパティが ButtonType.Button または ButtonType.Link に設定されている場合は、InsertText プロパティを使用して、Insert ボタンに表示するテキストを指定します。

メモ
Insert ボタンにテキストを表示する代わりに、ButtonType プロパティを ButtonType.Image に設定し、次に InsertImageUrl プロパティを設定して、イメージを表示することもできます。

このプロパティを設定している場合、デザイナツールを使用して、その値を自動的にリソースファイルに保存できます。詳細については、LocalizableAttribute、ASP.NET のグローバリゼーションおよびローカリゼーションの各トピックを参照してください。

使用例

InsertText プロパティを使用して、DetailsView コントロールの CommandField フィールドに表示される Insert ボタンのカスタムキャプションを指定する方法を次のコード例に示します。

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"
            inserttext="Save"
            newtext="Add New Customer" 
            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"
            inserttext="Save"
            newtext="Add New Customer" 
            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 名前空間
ButtonFieldBase.ButtonType プロパティ
CommandField.CancelImageUrl プロパティ
CommandField.CancelText プロパティ
CommandField.DeleteImageUrl プロパティ
CommandField.DeleteText プロパティ
CommandField.EditImageUrl プロパティ
CommandField.EditText プロパティ
CommandField.InsertImageUrl プロパティ
NewImageUrl
NewText
SelectImageUrl
SelectText
ShowCancelButton
ShowInsertButton
UpdateImageUrl
UpdateText

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

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

CommandField.InsertText プロパティ

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


	© 2025 Microsoft.All rights reserved.

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

CommandField.InsertText プロパティ

急上昇のことば

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

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