Partager via

DetailsView.AutoGenerateInsertButton Propriété

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une valeur indiquant si les contrôles intégrés pour insérer un nouvel enregistrement sont affichés dans un DetailsView contrôle.

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 pour 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 prenant 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.

Note

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 insert query.

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. Cliquez sur le bouton Insérer pour insérer le nouvel enregistrement dans la source de données et retourne le contrôle au mode spécifié par la DefaultMode propriété. Le fait de cliquer sur le bouton Annuler abandonne l’opération d’insertion et retourne le contrôle en mode par défaut.

Note

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 d’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 après que le DetailsView contrôle insère 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 insère l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération d’insertion.
ModeChanged Se produit après que le DetailsView contrôle change les modes.
ModeChanging Se produit avant que le DetailsView contrôle change de mode. Cet événement est souvent utilisé pour annuler la modification du mode.

La valeur de celle-ci AutoGenerateInsertButton est stockée dans l’état d’affichage.

S’applique à

Voir aussi