GridView.AutoGenerateEditButton Propriété

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.

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.

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.

S’applique à

Voir aussi

• CommandField
• AutoGenerateDeleteButton
• AutoGenerateSelectButton
• AutoGenerateColumns
• DataKeys
• DataKeyNames
• EditIndex
• EditRowStyle
• RowCancelingEdit
• RowEditing
• RowUpdated
• RowUpdating