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

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

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

CommandField.NewImageUrl プロパティ

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

CommandField フィールドの New ボタンに表示するイメージの URL を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 NewImageUrl As String

Visual Basic (使用法)

Dim instance As CommandField
Dim value As String

value = instance.NewImageUrl

instance.NewImageUrl = value

public virtual string NewImageUrl { get;
 set; }

C++

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

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

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

JScript

public function get NewImageUrl
 () : String

public function set NewImageUrl
 (value : String)

プロパティ値
CommandField の New ボタンに表示するイメージの URL。既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

解説

CommandField フィールドの ButtonType プロパティが ButtonType.Image に設定されている場合は、NewImageUrl プロパティを使用して、New ボタンに表示するイメージを指定します。クライアントのブラウザでサポートされてさえいれば、このイメージにはどのようなファイル形式 (.jpg、.gif、.bmp など) でも使用できます。

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

使用例

NewImageUrl プロパティを使用して、DetailsView コントロールの CommandField 列フィールドの New ボタンに表示するカスタムイメージを指定する方法を次のコード例に示します。New ボタンにイメージを表示するには、ButtonType プロパティを ButtonType.Image に設定する必要があります。

Visual Basic

<%@ 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"
            buttontype="Image"
            insertimageurl="~\Images\InsertButton.jpg"
            newimageurl="~\Images\AddButton.jpg"
            cancelimageurl="~\Images\CancelButton.jpg"
  
            showheader="true"
            headertext="Add Store"/>
        </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"
            buttontype="Image"
            insertimageurl="~\Images\InsertButton.jpg"
            newimageurl="~\Images\AddButton.jpg"
            cancelimageurl="~\Images\CancelButton.jpg"  
            showheader="true"
            headertext="Add Store"/>
        </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 プロパティ
CommandField.InsertText プロパティ
NewText
SelectImageUrl
SelectText
ShowCancelButton
ShowInsertButton
UpdateImageUrl
UpdateText

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

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

CommandField.NewImageUrl プロパティ

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


	© 2025 Microsoft.All rights reserved.

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

CommandField.NewImageUrl プロパティ

急上昇のことば

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

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