CommandField.ShowInsertButton Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een knop Nieuw wordt weergegeven in een CommandField veld.
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 BooleanWaarde van eigenschap
trueom een knop Nieuw weer te geven in een CommandField; anders. false De standaardwaarde is false.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ShowInsertButton eigenschap gebruikt om een knop Nieuw weer te geven in een DetailsView besturingselement, zodat de gebruiker een nieuwe record aan de gegevensbron kan toevoegen.
<%@ 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>
Opmerkingen
Gebruik de ShowInsertButton eigenschap om op te geven of een knop Nieuw wordt weergegeven in een CommandField veld. De knop Nieuw wordt slechts eenmaal weergegeven in het CommandField veld en stelt de gebruiker in staat een nieuwe record toe te voegen in de gegevensbron.
Note
Deze eigenschap is alleen van toepassing op gegevensgebonden besturingselementen die ondersteuning bieden voor invoegbewerkingen, zoals het DetailsView besturingselement.
Wanneer de gebruiker op de knop Nieuw klikt, worden invoerbesturingselementen weergegeven voor elk veld dat wordt weergegeven in het gegevensgebonden besturingselement, zodat de gebruiker de waarden voor de nieuwe record kan invoeren. De knop Nieuw wordt vervangen door een knop Invoegen en een knop Annuleren en alle andere opdrachtknoppen in het CommandField veld zijn verborgen. Als u op de knop Invoegen klikt, wordt de record toegevoegd aan de gegevensbron, terwijl de bewerking wordt geannuleerd door op de knop Annuleren te klikken.
Note
Wanneer een gegevensgebonden besturingselement wordt gebruikt in combinatie met een gegevensbronbesturingselement (zoals een SqlDataSource besturingselement), kan het gegevensgebonden besturingselement profiteren van de mogelijkheden van het besturingselement voor gegevensbronnen en automatische invoegfunctionaliteit bieden. Voor andere gegevensbronnen moet u de routines opgeven om de invoegbewerking uit te voeren tijdens de juiste gebeurtenis voor het gegevensgebonden besturingselement.
Wanneer de ButtonType eigenschap van een CommandField veld is ingesteld op ButtonType.Button of ButtonType.Link, gebruikt u de NewText eigenschap om de tekst op te geven die moet worden weergegeven voor een knop Nieuw. U kunt ook een afbeelding weergeven door eerst de ButtonType eigenschap in te ButtonType.Image stellen op en vervolgens de NewImageUrl eigenschap in te stellen.
