GridView.AutoGenerateEditButton GridView.AutoGenerateEditButton GridView.AutoGenerateEditButton GridView.AutoGenerateEditButton Property

Definizione

Ottiene o imposta un valore che indica se a un controllo CommandField viene aggiunta automaticamente una colonna associata a campo GridView con un pulsante Modifica per ciascuna riga di dati.Gets or sets a value indicating whether a CommandField field column with an Edit button for each data row is automatically added to a GridView 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

Valore della proprietà

true per aggiungere automaticamente una colonna associata a campo CommandField con un pulsante Modifica per ciascuna riga di dati, altrimenti false.true to automatically add a CommandField field column with an Edit button for each data row; otherwise, false. Il valore predefinito è false.The default is false.

Esempi

Nell'esempio seguente viene illustrato come utilizzare la AutoGenerateEditButton proprietà per abilitare la funzionalità GridView di modifica automatica del controllo.The following example demonstrates how to use the AutoGenerateEditButton property to enable the automatic editing feature of the GridView control.

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

Commenti

Quando un controllo origine dati che supporta l'aggiornamento è associato a GridView un controllo, GridView il controllo può sfruttare le funzionalità del controllo origine dati e fornire funzionalità di aggiornamento automatico.When a data source control that supports updating is bound to a GridView control, the GridView control can take advantage of the data source control's capabilities and provide automatic updating functionality.

Nota

Per aggiornare i dati, un controllo origine dati deve essere configurato in modo da aggiornare i dati.For a data source control to update data, it must be configured to update data. Per configurare un controllo origine dati per aggiornare i record, vedere la documentazione per il controllo origine dati specifico.To configure a data source control to update records, see the documentation for the specific data source control.

Quando la AutoGenerateEditButton proprietà è impostata su true, al GridView controllo viene aggiunta automaticamente una CommandField colonna, rappresentata da un oggetto, con un pulsante modifica per ogni riga di dati.When the AutoGenerateEditButton property is set to true, a column (represented by a CommandField object) with an Edit button for each data row is automatically added to the GridView control. Se si fa clic su un pulsante modifica per una riga, la riga viene inserita in modalità di modifica.Clicking an Edit button for a row puts that row in edit mode. Quando una riga è in modalità di modifica, ogni campo di colonna della riga che non è in sola lettura Visualizza il controllo di input appropriato, ad TextBox esempio un controllo, per il tipo di dati del campo.When a row is in edit mode, each column field in the row that is not read-only displays the appropriate input control, such as a TextBox control, for the field's data type. Ciò consente all'utente di modificare il valore del campo.This allows the user to modify the field's value.

Quando si fa clic sul pulsante modifica viene sostituito anche con un pulsante Aggiorna e un pulsante Annulla.When clicked, the Edit button is also replaced with an Update button and a Cancel button. Se si fa clic sul pulsante Aggiorna, la riga nell'origine dati viene aggiornata con le modifiche apportate al valore e la riga viene visualizzata in modalità di visualizzazione.Clicking the Update button updates the row in the data source with any value changes and returns the row to display mode. Se si fa clic sul pulsante Annulla, le modifiche apportate al valore vengono rilasciate e la riga viene visualizzata in modalitàClicking the Cancel button abandons any value changes and returns the row to display mode.

Nota

È possibile inserire una riga a livello di codice in modalità di modifica EditIndex impostando la proprietà con l'indice della riga.You can programmatically put a row in edit mode by setting the EditIndex property with the index of the row. Per uscire dalla modalità di modifica a livello di EditIndex codice, impostare la proprietà su-1.To programmatically exit edit mode, set the EditIndex property to -1.

Quando si utilizza la funzionalità di aggiornamento incorporata, è necessario impostare DataKeyNames la proprietà con un elenco delimitato da virgole di nomi di campo per identificare il campo o i campi di chiave primaria dell'origine dati. in caso contrario, la funzionalità di aggiornamento predefinita non sarà in grado di aggiornare il record corretto.When using the built-in updating functionality, you must set the DataKeyNames property with a comma-separated list of field names to identify the primary key field or fields of the data source; otherwise, the built-in updating functionality will not be able to update the correct record. Quando si utilizzano colonne di campo generate automaticamente, AutoGenerateColumns impostando truela proprietà su GridView , il controllo assicura automaticamente che le colonne di campo generate automaticamente che corrispondono al campo o ai campi specificati in la DataKeyNames proprietà è di sola lettura.When using automatically generated field columns (by setting the AutoGenerateColumns property to true), the GridView control automatically ensures that the automatically generated field columns that correspond to the field or fields specified in the DataKeyNames property are read-only.

È possibile controllare l'aspetto di una riga in modalità di modifica tramite la EditRowStyle proprietà.You can control the appearance of a row that is in edit mode by using the EditRowStyle property. Le impostazioni comuni includono generalmente un colore di sfondo personalizzato, un colore di primo piano e le proprietà del tipo di carattere.Common settings usually include a custom background color, foreground color, and font properties.

Il GridView controllo fornisce diversi eventi che è possibile usare per eseguire un'azione personalizzata quando viene aggiornata una riga.The GridView control provides several events that you can use to perform a custom action when a row is updated. Nella tabella seguente sono elencati gli eventi disponibili.The following table lists the available events.

eventEvent DescriptionDescription
RowCancelingEdit Si verifica quando si fa clic sul pulsante Annulla di una riga, ma GridView prima che il controllo annulla la modalità di modifica.Occurs when a row's Cancel button is clicked, but before the GridView control cancels out of edit mode. Questo evento viene spesso usato per arrestare l'operazione di annullamento.This event is often used to stop the canceling operation.
RowEditing Si verifica quando viene fatto clic sul pulsante Modifica di una riga, ma prima che il controllo GridView passi alla modalità di modifica.Occurs when a row's Edit button is clicked, but before the GridView control enters edit mode. Questo evento viene spesso utilizzato per annullare l'operazione di modifica.This event is often used to cancel the editing operation.
RowUpdated Si verifica quando viene fatto clic sul pulsante Aggiorna di una riga, ma dopo che il controllo GridView ha aggiornato la riga.Occurs when a row's Update button is clicked, but after the GridView control updates the row. Questo evento viene spesso usato per verificare i risultati dell'operazione di aggiornamento.This event is often used to check the results of the update operation.
RowUpdating Si verifica quando viene fatto clic sul pulsante Aggiorna di una riga, ma prima che il controllo GridView aggiorni la riga.Occurs when a row's Update button is clicked, but before the GridView control updates the row. Questo evento viene spesso utilizzato per annullare l'operazione di aggiornamento.This event is often used to cancel the updating operation.

Si applica a

Vedi anche