DetailsView.AutoGenerateInsertButton 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 les contrôles intégrés pour insérer un nouvel enregistrement s'affichent dans un contrôle DetailsView.
public:
virtual property bool AutoGenerateInsertButton { bool get(); void set(bool value); };
public virtual bool AutoGenerateInsertButton { get; set; }
member this.AutoGenerateInsertButton : bool with get, set
Public Overridable Property AutoGenerateInsertButton As Boolean
Valeur de propriété
true
pour afficher les contrôles intégrés afin d'insérer un nouvel enregistrement ; sinon, false
. La valeur par défaut est false
.
Exemples
L’exemple de code suivant montre comment utiliser la AutoGenerateInsertButton propriété pour afficher les contrôles intégrés pour insérer un nouvel enregistrement dans un DetailsView contrôle.
<%@ 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>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AutoGenerateInsertButton Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateinsertbutton="true"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
</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="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country]
From [Customers]">
</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>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AutoGenerateInsertButton Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateinsertbutton="true"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
</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="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country]
From [Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Remarques
Lorsqu’un contrôle de source de données qui prend en charge l’insertion est lié à un DetailsView contrôle, le DetailsView contrôle peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités d’insertion automatique.
Notes
Pour qu’un contrôle de source de données insère des données, sa SqlDataSource.InsertCommand propriété doit être définie avec une instruction de requête Insert.
Lorsque la AutoGenerateInsertButton propriété est définie true
sur , un CommandField champ de ligne avec un bouton Nouveau s’affiche automatiquement dans le DetailsView contrôle. Cliquer sur le bouton Nouveau place ce DetailsView contrôle en mode Insertion. En mode Insertion, chaque champ lié du contrôle qui n’est pas en lecture seule affiche le contrôle d’entrée approprié, tel qu’un TextBox contrôle, pour le type de données du champ. Cela permet à l’utilisateur d’entrer la valeur du champ pour le nouvel enregistrement.
Lorsque vous cliquez sur ce bouton, le bouton Nouveau est également remplacé par un bouton Insérer et un bouton Annuler. Cliquer sur le bouton Insérer insère le nouvel enregistrement dans la source de données et retourne le contrôle au mode spécifié par la DefaultMode propriété. Cliquer sur le bouton Annuler abandonne l’opération d’insertion et retourne le contrôle en mode par défaut.
Notes
Pour placer une ligne en mode Insertion par programmation, utilisez la ChangeMode méthode.
Vous pouvez contrôler l’apparence d’un enregistrement en mode Insertion à l’aide de la InsertRowStyle propriété. Les paramètres courants incluent généralement une couleur d’arrière-plan personnalisée, une couleur de premier plan et des propriétés de police.
Le DetailsView contrôle fournit plusieurs événements que vous pouvez utiliser pour effectuer une action personnalisée lorsqu’un nouvel enregistrement est inséré. Le tableau suivant répertorie les événements disponibles.
Événement | Description |
---|---|
ItemInserted | Se produit lorsque le bouton Insérer est cliqué, mais une fois que le DetailsView contrôle a inséré l’enregistrement. Cet événement est souvent utilisé pour vérifier les résultats de l’opération d’insertion. |
ItemInserting | Se produit lorsque le bouton Insérer est cliqué, mais avant que le DetailsView contrôle n’insère l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération d’insertion. |
ModeChanged | Se produit après que le contrôle change de DetailsView mode. |
ModeChanging | Se produit avant que le contrôle change de DetailsView mode. Cet événement est souvent utilisé pour annuler la modification du mode. |
La valeur est AutoGenerateInsertButton stockée dans l’état d’affichage.