CommandField.InsertImageUrl Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der URL auf ein Bild, das für die Schaltfläche "Einfügen" in einem CommandField Feld angezeigt werden soll.
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, setPublic Overridable Property InsertImageUrl As StringEigenschaftswert
Die URL zu einem Bild, das für die Schaltfläche "Einfügen" in einem CommandFieldBild angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die InsertImageUrl Eigenschaft verwendet wird, um ein benutzerdefiniertes Bild anzugeben, das für eine Einfügeschaltfläche in einem CommandField Feld eines DetailsView Steuerelements angezeigt werden soll. Die ButtonType Eigenschaft muss für eine Schaltfläche "Einfügen" festgelegt ButtonType.Image werden, um ein Bild anzuzeigen.
<%@ 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>
Hinweise
Wenn die ButtonType Eigenschaft eines CommandField Felds auf festgelegt ButtonType.Imageist, geben Sie mithilfe der InsertImageUrl Eigenschaft das Bild an, das für eine Schaltfläche "Einfügen" angezeigt werden soll. Dieses Bild kann in einem beliebigen Dateiformat vorliegen (.jpg, .gif, .bmpusw.), solange der Browser des Clients dieses Format unterstützt.
Hinweis
Als Alternative zum Anzeigen eines Bilds für die Schaltfläche "Einfügen" können Sie Text anzeigen, indem Sie zuerst die ButtonType Eigenschaft auf ButtonType.Button oder ButtonType.Link dann die InsertText Eigenschaft festlegen.
