CommandField.ShowInsertButton 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 eines Werts, der angibt, ob eine neue Schaltfläche in einem CommandField Feld angezeigt wird.
public:
virtual property bool ShowInsertButton { bool get(); void set(bool value); };public virtual bool ShowInsertButton { get; set; }member this.ShowInsertButton : bool with get, setPublic Overridable Property ShowInsertButton As BooleanEigenschaftswert
true zum Anzeigen einer Schaltfläche "Neu" in einem CommandField; andernfalls false. Der Standardwert lautet false.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die ShowInsertButton Eigenschaft zum Anzeigen einer Schaltfläche "Neu" in einem DetailsView Steuerelement verwendet wird, sodass der Benutzer der Datenquelle einen neuen Datensatz hinzufügen kann.
<%@ 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"
showheader="true"
headertext="Add Customer"/>
</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="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: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"
showheader="true"
headertext="Add Customer"/>
</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
Verwenden Sie die ShowInsertButton Eigenschaft, um anzugeben, ob eine Neue Schaltfläche in einem CommandField Feld angezeigt wird. Die Schaltfläche "Neu" wird nur einmal im CommandField Feld angezeigt und ermöglicht dem Benutzer das Hinzufügen eines neuen Datensatzes in der Datenquelle.
Hinweis
Diese Eigenschaft gilt nur für datengebundene Steuerelemente, die Einfügevorgänge unterstützen, z. B. das DetailsView Steuerelement.
Wenn der Benutzer auf die Schaltfläche "Neu" klickt, werden Eingabesteuerelemente für jedes Feld angezeigt, das im datengebundenen Steuerelement angezeigt wird, sodass der Benutzer die Werte für den neuen Datensatz eingeben kann. Die Schaltfläche "Neu" wird durch eine Schaltfläche "Einfügen" und eine Schaltfläche "Abbrechen" ersetzt, und alle anderen Befehlsschaltflächen im CommandField Feld sind ausgeblendet. Durch Klicken auf die Schaltfläche "Einfügen" wird der Datenquelle der Datensatz hinzugefügt, während durch Klicken auf die Schaltfläche "Abbrechen" der Vorgang abgebrochen wird.
Hinweis
Wenn ein datengebundenes Steuerelement in Kombination mit einem Datenquellensteuerelement (z. B. einem SqlDataSource Steuerelement) verwendet wird, kann das datengebundene Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Einfügefunktionen bereitstellen. Für andere Datenquellen müssen Sie die Routinen angeben, um den Einfügevorgang während des entsprechenden Ereignisses für das datengebundene Steuerelement auszuführen.
Wenn die ButtonType Eigenschaft eines CommandField Felds auf ButtonType.Button oder ButtonType.Link, verwenden Sie die NewText Eigenschaft, um den Text anzugeben, der für eine Schaltfläche "Neu" angezeigt werden soll. Alternativ können Sie ein Bild anzeigen, indem Sie zuerst die ButtonType Eigenschaft auf ButtonType.Image und dann die NewImageUrl Eigenschaft festlegen.
