Partager via


DetailsView.AutoGenerateInsertButton Propriété

Définition

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é

Boolean

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 truesur , 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.

S’applique à

Voir aussi