CommandField.InsertImageUrl 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定要為 CommandField 欄位中 [插入] 按鈕顯示之影像的 URL。
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。 預設為空字串 (""),表示這個屬性未設定。
範例
下列程式碼範例示範如何使用 InsertImageUrl 屬性來指定要在控制項欄位中顯示 [插入] 按鈕 CommandField 的 DetailsView 自訂影像。 屬性 ButtonType 必須設定為 ButtonType.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 屬性來指定要顯示 [插入] 按鈕的影像。 只要用戶端的瀏覽器支援該格式,此影像可以是任何檔案格式 (.jpg、.gif、.bmp等等) 。
注意
除了顯示 [插入] 按鈕的影像,您也可以先將 屬性設定 ButtonType 為 ButtonType.Button
或 ButtonType.Link
,然後設定 InsertText 屬性來顯示文字。