DetailsView.AutoGenerateEditButton Propriété

Définition

Obtient ou définit une valeur indiquant si les contrôles intégrés pour modifier l'enregistrement actuel s'affichent dans un contrôle DetailsView.Gets or sets a value indicating whether the built-in controls to edit the current record are displayed in a DetailsView control.

public:
 virtual property bool AutoGenerateEditButton { bool get(); void set(bool value); };
public virtual bool AutoGenerateEditButton { get; set; }
member this.AutoGenerateEditButton : bool with get, set
Public Overridable Property AutoGenerateEditButton As Boolean

Valeur de propriété

Boolean

true pour afficher les contrôle intégrés afin de modifier l'enregistrement actuel ; sinon, false.true to display the built-in controls to edit the current record; otherwise, false. La valeur par défaut est false.The default is false.

Exemples

L’exemple de code suivant montre comment utiliser la AutoGenerateEditButton propriété pour afficher les contrôles intégrés afin de modifier l’enregistrement en cours.The following code example demonstrates how to use the AutoGenerateEditButton property to display the built-in controls to edit the current record.


<%@ 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 AutoGenerateEditButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateEditButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="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 AutoGenerateEditButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateEditButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="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 la mise à jour 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 la fonctionnalité de mise à jour automatique.When a data source control that supports updating is bound to a DetailsView control, the DetailsView control can take advantage of the data source control's capabilities and provide automatic updating functionality.

Notes

Pour qu’un contrôle de source de données met à jour des données, sa SqlDataSource.UpdateCommand propriété doit être définie avec une instruction de requête Update.For a data source control to update data, its SqlDataSource.UpdateCommand property must be set with an update query statement.

Lorsque la AutoGenerateEditButton propriété a la valeur true , un CommandField champ de ligne avec un bouton modifier s’affiche automatiquement dans le DetailsView contrôle.When the AutoGenerateEditButton property is set to true, a CommandField row field with an Edit button is automatically displayed in the DetailsView control. Le fait de cliquer sur le bouton modifier met ce DetailsView contrôle en mode édition.Clicking the Edit button puts that DetailsView control in edit mode. En mode édition, 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 edit 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 de modifier la valeur du champ.This allows the user to modify the field's value.

Lorsque vous cliquez dessus, le bouton modifier est également remplacé par un bouton mettre à jour et un bouton Annuler.When clicked, the Edit button is also replaced with an Update button and a Cancel button. Le fait de cliquer sur le bouton mettre à jour met à jour l’enregistrement de la source de données avec toutes les valeurs modifiées et retourne le contrôle au mode spécifié par la DefaultMode propriété.Clicking the Update button updates the record in the data source with any value changes and returns the control to the mode specified by the DefaultMode property. Le fait de cliquer sur le bouton Annuler permet d’abandonner toute modification de valeur et de revenir au mode par défaut du contrôle.Clicking the Cancel button abandons any value changes and returns the control to the default mode.

Notes

Pour mettre un DetailsView contrôle en mode édition par programme, utilisez la ChangeMode méthode.To put a DetailsView control in edit mode programmatically, use the ChangeMode method.

Lorsque la AutoGenerateRows propriété a également la valeur true , le DetailsView contrôle garantit automatiquement que le ou les champs spécifiés dans la DataKeyNames propriété sont en lecture seule.When the AutoGenerateRows property is also set to true, the DetailsView control automatically ensures that the field or fields specified in the DataKeyNames property are read-only.

Notes

À moins que vous implémentiez vos propres fonctionnalités de mise à jour, vous devez définir la DataKeyNames propriété pour que la fonctionnalité de mise à jour automatique fonctionne.Unless you implement your own updating functionality, you must set the DataKeyNames property for the automatic updating feature to work.

Vous pouvez contrôler l’apparence des lignes de données lorsque le DetailsView contrôle est en mode édition à l’aide de la EditRowStyle propriété.You can control the appearance of the data rows when the DetailsView control is in edit mode by using the EditRowStyle 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 lorsqu’un enregistrement est mis à jour.The DetailsView control provides several events that you can use to perform a custom action when a record is updated. Le tableau suivant répertorie les événements disponibles.The following table lists the available events.

ÉvénementEvent DescriptionDescription
ItemUpdated Se produit lorsque l’utilisateur clique sur le bouton mettre à jour, mais après que le DetailsView contrôle a mis à jour l’enregistrement.Occurs when the Update button is clicked, but after the DetailsView control updates the record. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de mise à jour.This event is often used to check the results of the update operation.
ItemUpdating Se produit lorsque l’utilisateur clique sur le bouton mettre à jour, mais avant que le DetailsView contrôle ne met à jour l’enregistrement.Occurs when the Update button is clicked, but before the DetailsView control updates the record. Cet événement est souvent utilisé pour annuler l’opération de mise à jour.This event is often used to cancel the update 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 AutoGenerateEditButton est stockée dans l’état d’affichage.The value of AutoGenerateEditButton is stored in view state.

S’applique à

Voir aussi