CommandField.ShowInsertButton Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si un bouton Nouveau est affiché dans un champ CommandField.
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 BooleanValeur de propriété
true pour afficher un bouton Nouveau dans un CommandField ; sinon, false. La valeur par défaut est false.
Exemples
L’exemple de code suivant montre comment utiliser la ShowInsertButton propriété pour afficher un bouton Nouveau dans un DetailsView contrôle, ce qui permet à l’utilisateur d’ajouter un nouvel enregistrement à la source de données.
<%@ 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>
Remarques
Utilisez la ShowInsertButton propriété pour spécifier si un bouton Nouveau s’affiche dans un CommandField champ. Le bouton Nouveau ne s’affiche qu’une seule fois dans le CommandField champ et permet à l’utilisateur d’ajouter un nouvel enregistrement dans la source de données.
Notes
Cette propriété s’applique uniquement aux contrôles liés aux données qui prennent en charge les opérations d’insertion, telles que le DetailsView contrôle.
Lorsque l’utilisateur clique sur le bouton Nouveau, les contrôles d’entrée s’affichent pour chaque champ affiché dans le contrôle lié aux données, ce qui lui permet d’entrer les valeurs du nouvel enregistrement. Le bouton Nouveau est remplacé par un bouton Insérer et un bouton Annuler, et tous les autres boutons de commande du CommandField champ sont masqués. Le fait de cliquer sur le bouton Insérer ajoute l’enregistrement à la source de données, tandis que le fait de cliquer sur le bouton Annuler annule l’opération.
Notes
Lorsqu’un contrôle lié aux données est utilisé en combinaison avec un contrôle de source de données (tel qu’un SqlDataSource contrôle), le contrôle lié aux données peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités d’insertion automatique. Pour les autres sources de données, vous devez fournir les routines pour effectuer l’opération d’insertion pendant l’événement approprié pour le contrôle lié aux données.
Lorsque la ButtonType propriété d’un CommandField champ a la ButtonType.Button valeur ou ButtonType.Link, utilisez la NewText propriété pour spécifier le texte à afficher pour un bouton Nouveau. Vous pouvez également afficher une image en définissant d’abord la ButtonType propriété sur ButtonType.Image , puis en définissant la NewImageUrl propriété.
