CommandField.EditImageUrl プロパティ

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

CommandField.EditImageUrl プロパティ

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

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

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

Visual Basic (宣言)

Public Overridable Property
 EditImageUrl As String

Visual Basic (使用法)

Dim instance As CommandField
Dim value As String

value = instance.EditImageUrl

instance.EditImageUrl = value

C#

public virtual string EditImageUrl { get;
 set; }

C++

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

J#

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

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

JScript

public function get EditImageUrl
 () : String

public function set EditImageUrl
 (value : String)

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

解説

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

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

使用例

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

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 名前空間
ButtonFieldBase.ButtonType プロパティ
CommandField.CancelImageUrl プロパティ
CommandField.CancelText プロパティ
CommandField.DeleteImageUrl プロパティ
CommandField.DeleteText プロパティ
CommandField.EditImageUrl プロパティ
EditText
InsertText
NewImageUrl
NewText
SelectImageUrl
SelectText
ShowCancelButton
ShowEditButton
UpdateImageUrl
UpdateText