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.Gets or sets a value indicating whether the built-in controls to insert a new record are displayed in a DetailsView control.

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.true to display the built-in controls to insert a new record; otherwise, false. La valeur par défaut est false.The default is false.

Exemples

L’exemple de code suivant montre comment utiliser la AutoGenerateInsertButton propriété pour afficher les contrôles intégrés afin d’insérer un nouvel enregistrement dans un DetailsView contrôle.The following code example demonstrates how to use the AutoGenerateInsertButton property to display the built-in controls to insert a new record in a DetailsView control.


<%@ 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 une fonctionnalité d’insertion automatique.When a data source control that supports inserting is bound to a DetailsView control, the DetailsView control can take advantage of the data source control's capabilities and provide automatic inserting functionality.

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.For a data source control to insert data, its SqlDataSource.InsertCommand property must be set with an insert query statement.

Lorsque la AutoGenerateInsertButton propriété a la valeur true , un CommandField champ de ligne avec un bouton nouveau est automatiquement affiché dans le DetailsView contrôle.When the AutoGenerateInsertButton property is set to true, a CommandField row field with a New button is automatically displayed in the DetailsView control. Le fait de cliquer sur le bouton nouveau met ce DetailsView contrôle en mode insertion.Clicking the New button puts that DetailsView control in insert mode. En mode insertion, chaque champ lié dans le 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.When in insert mode, each bound field in the control that is not read-only displays the appropriate input control, such as a TextBox control, for the field's data type. Cela permet à l’utilisateur d’entrer la valeur du champ pour le nouvel enregistrement.This allows the user to enter the field's value for the new record.

Lorsque vous cliquez dessus, le bouton nouveau est également remplacé par un bouton Insérer et un bouton Annuler.When clicked, the New button is also replaced with an Insert button and a Cancel button. 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é.Clicking the Insert button inserts the new record in the data source and returns the control to the mode specified by the DefaultMode property. Cliquer sur le bouton Annuler abandonne l’opération d’insertion et retourne le contrôle au mode par défaut.Clicking the Cancel button abandons the insert operation and returns the control to the default mode.

Notes

Pour mettre une ligne en mode insertion par programme, utilisez la ChangeMode méthode.To put a row in insert mode programmatically, use the ChangeMode method.

Vous pouvez contrôler l’apparence d’un enregistrement en mode insertion à l’aide de la InsertRowStyle propriété.You can control the appearance of a record that is in insert mode by using the InsertRowStyle property. Les paramètres courants incluent généralement une couleur d’arrière-plan, une couleur de premier plan et des propriétés de police personnalisées.Common settings usually include a custom background color, foreground color, and font properties.

Le DetailsView contrôle fournit plusieurs événements que vous pouvez utiliser pour exécuter une action personnalisée lors de l’insertion d’un nouvel enregistrement.The DetailsView control provides several events that you can use to perform a custom action when a new record is inserted. Le tableau suivant répertorie les événements disponibles.The following table lists the available events.

ÉvénementEvent DescriptionDescription
ItemInserted Se produit lorsque l’utilisateur clique sur le bouton Insérer, mais après que le DetailsView contrôle a inséré l’enregistrement.Occurs when the Insert button is clicked, but after the DetailsView control inserts the record. Cet événement est souvent utilisé pour vérifier les résultats de l’opération d’insertion.This event is often used to check the results of the insert operation.
ItemInserting Se produit lorsque l’utilisateur clique sur le bouton Insérer, mais avant que le DetailsView contrôle n’insère l’enregistrement.Occurs when the Insert button is clicked, but before the DetailsView control inserts the record. Cet événement est souvent utilisé pour annuler l’opération d’insertion.This event is often used to cancel the insert operation.
ModeChanged Se produit une fois que le DetailsView contrôle a modifié les modes.Occurs after the DetailsView control changes modes.
ModeChanging Se produit avant que le DetailsView contrôle ne change de mode.Occurs before the DetailsView control changes modes. Cet événement est souvent utilisé pour annuler le changement de mode.This event is often used to cancel the mode change.

La valeur de AutoGenerateInsertButton est stockée dans l’état d’affichage.The value of AutoGenerateInsertButton is stored in view state.

S’applique à

Voir aussi