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
属性值
为 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 DetailsView 。The 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.Button 或 ButtonType.Link ,然后设置属性来显示文本 InsertText 。As 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.