CommandField.CancelImageUrl プロパティ

定義

CommandField フィールドの Cancel ボタンに表示するイメージの URL を取得または設定します。Gets or sets the URL to an image to display for the Cancel button in a CommandField field.

public:
 virtual property System::String ^ CancelImageUrl { System::String ^ get(); void set(System::String ^ value); };
public virtual string CancelImageUrl { get; set; }
member this.CancelImageUrl : string with get, set
Public Overridable Property CancelImageUrl As String

プロパティ値

String

CommandField の Cancel ボタンに表示するイメージの URL。The URL to an image to display for the Cancel button in a CommandField. 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。The default is an empty string (""), which indicates that this property is not set.

次のコード例は、プロパティを使用して、 CancelImageUrl コントロールのフィールドの [キャンセル] ボタンに表示するカスタムイメージを指定する方法を示して CommandField GridView います。The following code example demonstrates how to use the CancelImageUrl property to specify a custom image to display for a Cancel button in a CommandField field of a GridView control. ButtonType ButtonType.Image [キャンセル] ボタンをクリックして画像を表示するには、プロパティをに設定する必要があります。The ButtonType property must be set to ButtonType.Image for a Cancel button to display an image.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" 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>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" 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>

注釈

フィールドのプロパティがに設定されている場合は、プロパティを使用して、 ButtonType CommandField ButtonType.Image CancelImageUrl [キャンセル] ボタンに表示するイメージを指定します。When the ButtonType property of a CommandField field is set to ButtonType.Image, use the CancelImageUrl property to specify the image to display for the Cancel button. このイメージは、クライアントのブラウザーがその形式をサポートしている限り、任意のファイル形式 (.jpg、.gif、.bmp など) にすることができます。This image can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client's browser supports that format.

注意

[キャンセル] ボタンの画像を表示する代わりに、最初に ButtonType プロパティをまたはに設定して ButtonType.Button ButtonType.Link から、プロパティを設定 CancelText することによって、テキストを表示できます。As an alternative to displaying an image for the Cancel button, you can display text by first setting the ButtonType property to ButtonType.Button or ButtonType.Link and then setting the CancelText property.

適用対象

こちらもご覧ください