CommandField.UpdateImageUrl プロパティ

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

CommandField.UpdateImageUrl プロパティ

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

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

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

Visual Basic (宣言)

Public Overridable Property
 UpdateImageUrl As String

Visual Basic (使用法)

Dim instance As CommandField
Dim value As String

value = instance.UpdateImageUrl

instance.UpdateImageUrl = value

C#

public virtual string UpdateImageUrl { get;
 set; }

C++

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

J#

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

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

JScript

public function get UpdateImageUrl
 () : String

public function set UpdateImageUrl
 (value : String)

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

解説

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

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

使用例

UpdateImageUrl プロパティを使用して、GridView コントロールの CommandField フィールドの Update ボタンに表示するカスタム イメージを指定する方法を次のコード例に示します。Update ボタンにイメージを表示するには、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 プロパティ
CommandField.EditText プロパティ
CommandField.InsertImageUrl プロパティ
CommandField.InsertText プロパティ
CommandField.NewImageUrl プロパティ
CommandField.NewText プロパティ
CommandField.SelectImageUrl プロパティ
CommandField.SelectText プロパティ
CommandField.ShowCancelButton プロパティ
CommandField.ShowEditButton プロパティ
UpdateText