CommandField.InsertImageUrl 属性

定义

获取或设置为 CommandField 字段中的“插入”按钮显示的图像的 URL。Gets or sets the URL to an image to display for the Insert button in a CommandField field.

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

属性值

String

CommandField 中的“插入”按钮显示的图像的 URL。The URL to an image to display for the Insert button in a CommandField. 默认值为空字符串 (""),表示尚未设置此属性。The default is an empty string (""), which indicates that this property is not set.

示例

下面的代码示例演示如何使用 InsertImageUrl 属性为控件的字段中的 "插入" 按钮指定要显示的自定义图像 CommandField DetailsViewThe following code example demonstrates how to use the InsertImageUrl property to specify a custom image to display for an Insert button in a CommandField field of a DetailsView control. ButtonType若要显示图像,必须将属性设置为才能 ButtonType.Image 使用 "插入" 按钮。The ButtonType property must be set to ButtonType.Image for an Insert 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: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#" %>

<!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: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>

注解

ButtonType 字段的属性 CommandField 设置为时 ButtonType.Image ,使用 InsertImageUrl 属性指定要为 "插入" 按钮显示的图像。When the ButtonType property of a CommandField field is set to ButtonType.Image, use the InsertImageUrl property to specify the image to display for an Insert 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.ButtonButtonType.Link ,然后设置属性来显示文本 InsertTextAs an alternative to displaying an image for the Insert button, you can display text by first setting the ButtonType property to ButtonType.Button or ButtonType.Link and then setting the InsertText property.

适用于

另请参阅