Cette documentation est archivée et n’est pas conservée.

GridView.AutoGenerateEditButton, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient ou définit une valeur indiquant si une colonne de champs CommandField avec un bouton Modifier pour chaque ligne de données est ajoutée automatiquement à un contrôle GridView.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public virtual bool AutoGenerateEditButton { get; set; }
/** @property */
public boolean get_AutoGenerateEditButton ()

/** @property */
public void set_AutoGenerateEditButton (boolean value)

public function get AutoGenerateEditButton () : boolean

public function set AutoGenerateEditButton (value : boolean)

Valeur de la propriété

true pour ajouter automatiquement une colonne de champs CommandField avec un bouton Modifier pour chaque ligne de données ; sinon, false. La valeur par défaut est false.

Lorsqu'un contrôle de source de données prenant en charge la mise à jour est lié à un contrôle GridView, le contrôle GridView peut tirer parti des fonctionnalités du contrôle de source de données et fournir la fonctionnalité de mise à jour automatique.

RemarqueRemarque

Pour qu'un contrôle de source de données mette à jour des données, il doit être configuré pour mettre à jour des données. Pour configurer un contrôle de source de données afin de mettre à jour des enregistrements, consultez la documentation du contrôle de source de données spécifique.

Lorsque la propriété AutoGenerateEditButton a la valeur true, une colonne (représentée par un objet CommandField) avec un bouton Modifier pour chaque ligne de données est ajoutée automatiquement au contrôle GridView. Cliquer sur un bouton Modifier d'une ligne met cette ligne en mode édition. Lorsqu'une ligne est en mode édition, chaque champ de colonne dans la ligne qui n'est pas en lecture seule affiche le contrôle d'entrée approprié, tel qu'un contrôle TextBox pour le type de données du champ. Cela permet à l'utilisateur de modifier la valeur du champ.

Lorsque l'utilisateur a cliqué, le bouton Modifier est également remplacé par un bouton Mettre à jour et un bouton Annuler. Le bouton Mettre à jour permet de mettre à jour la ligne dans la source de données avec les modifications des valeurs et de retourner la ligne dans le mode d'affichage. Le bouton Annuler permet de ne pas prendre en compte les modifications des valeurs et de retourner la ligne dans le mode d'affichage.

RemarqueRemarque

Vous pouvez mettre par programme une ligne en mode édition en définissant la propriété EditIndex avec l'index de la ligne. Pour sortir par programme du mode édition, affectez la valeur -1 à la propriété EditIndex.

Lorsque vous utilisez la fonctionnalité intégrée de mise à jour, vous devez définir la propriété DataKeyNames avec une liste avec la virgule comme séparateur de noms de champs pour identifier le ou les champs clés primaires de la source de données ; sinon, la fonctionnalité intégrée de mise à jour ne pourra pas mettre à jour l'enregistrement correct. Lors de l'utilisation de colonnes de champs générées automatiquement (en attribuant à la propriété AutoGenerateColumns la valeur true), le contrôle GridView garantit automatiquement que les colonnes de champs générées automatiquement correspondant au(x) champ(s) spécifié(s) dans la propriété DataKeyNames sont en lecture seule.

Vous pouvez contrôler l'apparence d'une ligne en mode édition en utilisant la propriété EditRowStyle. Les paramètres communs incluent habituellement une couleur d'arrière-plan personnalisée, une couleur de premier plan et des propriétés de police.

Le contrôle GridView fournit plusieurs événements que vous pouvez utiliser pour exécuter une action personnalisée lorsqu'une ligne est mise à jour. Le tableau suivant répertorie les événements disponibles.

Événement

Description

RowCancelingEdit

Se produit lorsque l'utilisateur clique sur le bouton Annuler d'une ligne, mais avant que le contrôle GridView ne quitte sans enregistrer le mode édition. Cet événement est souvent utilisé pour arrêter l'opération d'annulation.

RowEditing

Se produit lors d'un clic sur le bouton Modification d'une ligne, mais avant que le contrôle GridView ne passe en mode édition. Cet événement est souvent utilisé pour annuler l'opération de modification.

RowUpdated

Se produit lors d'un clic sur le bouton Mise à jour d'une ligne, mais après que le contrôle GridView a mis la ligne à jour. Cet événement est souvent utilisé pour vérifier les résultats de l'opération de mise à jour.

RowUpdating

Se produit lors d'un clic sur le bouton Mise à jour d'une ligne, mais avant que le contrôle GridView ne mette la ligne à jour. Cet événement est souvent utilisé pour annuler l'opération de mise à jour.

L'exemple de code suivant montre comment utiliser la propriété AutoGenerateEditButton pour activer la fonctionnalité de modification automatique du contrôle GridView.


<%@ Page language="C#" %>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView Edit Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogeneratedeletebutton="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"  
        runat="server">
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: