Condividi tramite

GridView.AutoGenerateEditButton Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se una CommandField colonna di campo con un pulsante Modifica per ogni riga di dati viene aggiunta automaticamente a un GridView controllo .

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à

Boolean

true per aggiungere automaticamente una CommandField colonna di campo con un pulsante Modifica per ogni riga di dati; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la AutoGenerateEditButton proprietà per abilitare la funzionalità di modifica automatica del GridView controllo .

<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 un GridView controllo, il GridView controllo può sfruttare le funzionalità del controllo origine dati e fornire funzionalità di aggiornamento automatico.

Annotazioni

Affinché un controllo origine dati aggiorni i dati, è necessario configurarlo per aggiornare i dati. Per configurare un controllo origine dati per aggiornare i record, vedere la documentazione relativa al controllo origine dati specifico.

Quando la AutoGenerateEditButton proprietà è impostata su true, una colonna (rappresentata da un CommandField oggetto ) con un pulsante Modifica per ogni riga di dati viene aggiunta automaticamente al GridView controllo . Se si fa clic su un pulsante Modifica per una riga, tale riga viene inserita in modalità di modifica. Quando una riga è in modalità di modifica, ogni campo di colonna nella riga che non è di sola lettura visualizza il controllo di input appropriato, ad esempio un TextBox controllo, per il tipo di dati del campo. In questo modo l'utente può modificare il valore del campo.

Quando si fa clic, il pulsante Modifica viene sostituito anche con un pulsante Aggiorna e un pulsante Annulla. Facendo clic sul pulsante Aggiorna, la riga nell'origine dati viene aggiornata con qualsiasi modifica del valore e viene restituita la riga in modalità di visualizzazione. Facendo clic sul pulsante Annulla vengono abbandonate le modifiche apportate ai valori e viene restituita la riga in modalità di visualizzazione.

Annotazioni

È possibile inserire una riga in modalità di modifica a livello di codice impostando la EditIndex proprietà con l'indice della riga. Per uscire dalla modalità di modifica a livello di codice, impostare la EditIndex proprietà su -1.

Quando si utilizza la funzionalità di aggiornamento predefinita, è necessario impostare la DataKeyNames proprietà con un elenco delimitato da virgole di nomi di campo per identificare il campo o i campi chiave primaria dell'origine dati. In caso contrario, la funzionalità di aggiornamento predefinita non sarà in grado di aggiornare il record corretto. Quando si usano colonne di campo generate automaticamente (impostando la AutoGenerateColumns proprietà su true), il GridView controllo garantisce automaticamente che le colonne di campo generate automaticamente che corrispondono al campo o ai campi specificati nella DataKeyNames proprietà siano di sola lettura.

È possibile controllare l'aspetto di una riga in modalità di modifica usando la EditRowStyle proprietà . Le impostazioni comuni in genere includono un colore di sfondo personalizzato, il colore di primo piano e le proprietà del carattere.

Il GridView controllo fornisce diversi eventi che è possibile utilizzare per eseguire un'azione personalizzata quando viene aggiornata una riga. Nella tabella seguente sono elencati gli eventi disponibili.

Event Descrizione
RowCancelingEdit Si verifica quando si fa clic sul pulsante Annulla di una riga, ma prima che il GridView controllo annulla la modalità di modifica. Questo evento viene spesso usato per arrestare l'operazione di annullamento.
RowEditing Si verifica quando si fa clic sul pulsante Modifica di una riga, ma prima che il controllo entri in GridView modalità di modifica. Questo evento viene spesso usato per annullare l'operazione di modifica.
RowUpdated Si verifica quando si fa clic sul pulsante Aggiorna di una riga, ma dopo che il GridView controllo aggiorna la riga. Questo evento viene spesso usato per controllare i risultati dell'operazione di aggiornamento.
RowUpdating Si verifica quando si fa clic sul pulsante Aggiorna di una riga, ma prima che il GridView controllo aggiorni la riga. Questo evento viene spesso usato per annullare l'operazione di aggiornamento.

Si applica a

Vedi anche