GridView.AutoGenerateEditButton Propriété

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

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

Exemples

L’exemple suivant montre comment utiliser la AutoGenerateEditButton propriété pour activer la fonctionnalité d’édition automatique du GridView contrôle.

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

Remarques

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

Notes

Pour qu’un contrôle de source de données puisse mettre à jour les données, il doit être configuré pour mettre à jour les données. Pour configurer un contrôle de source de données pour mettre à jour les enregistrements, consultez la documentation relative au contrôle de source de données spécifique.

Lorsque la AutoGenerateEditButton propriété est définie truesur , une colonne (représentée par un CommandField objet) avec un bouton Modifier pour chaque ligne de données est automatiquement ajoutée au GridView contrôle. Cliquer sur un bouton Modifier pour une ligne place cette ligne en mode Édition. Lorsqu’une ligne est en mode édition, chaque champ de colonne de la ligne 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 de modifier la valeur du champ.

Lorsque vous cliquez sur ce bouton, le bouton Modifier est également remplacé par un bouton Mettre à jour et un bouton Annuler. Le fait de cliquer sur le bouton Mettre à jour met à jour la ligne de la source de données avec toutes les modifications de valeur et retourne la ligne en mode d’affichage. Le fait de cliquer sur le bouton Annuler abandonne toutes les modifications de valeur et retourne la ligne en mode d’affichage.

Notes

Vous pouvez placer par programmation une ligne en mode édition en définissant la EditIndex propriété avec l’index de la ligne. Pour quitter le mode d’édition par programmation, définissez la EditIndex propriété sur -1.

Lorsque vous utilisez la fonctionnalité de mise à jour intégrée, vous devez définir la DataKeyNames propriété avec une liste séparée par des virgules de noms de champs pour identifier le ou les champs de clé primaire de la source de données ; sinon, la fonctionnalité de mise à jour intégrée ne pourra pas mettre à jour l’enregistrement correct. Lorsque vous utilisez des colonnes de champ générées automatiquement (en définissant la AutoGenerateColumns propriété truesur ), le GridView contrôle garantit automatiquement que les colonnes de champ générées automatiquement qui correspondent au champ ou aux champs spécifiés dans la DataKeyNames propriété sont en lecture seule.

Vous pouvez contrôler l’apparence d’une ligne en mode édition à l’aide de la EditRowStyle 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 GridView contrôle fournit plusieurs événements que vous pouvez utiliser pour effectuer 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 le bouton Annuler d’une ligne est cliqué, mais avant que le GridView contrôle n’annule le mode d’é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 d’édition.
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.

S’applique à