GridView.AutoGenerateEditButton Proprietà

  • Riferimento

Definizione

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

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.

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 colonna associata a campo CommandField con un pulsante Modifica per ciascuna riga di dati, altrimenti false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come usare 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.

Nota

Per un controllo origine dati per aggiornare i dati, è necessario configurarlo per aggiornare i dati. Per configurare un controllo origine dati per aggiornare i record, vedere la documentazione per il controllo dell'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. Facendo clic su un pulsante Modifica per una riga viene inserita la riga 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. Ciò consente all'utente di 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 viene aggiornata la riga nell'origine dati con qualsiasi modifica del valore e viene restituita la riga in modalità di visualizzazione. Facendo clic sul pulsante Annulla viene abbandonata qualsiasi modifica del valore e viene restituita la riga in modalità di visualizzazione.

Nota

È possibile inserire a livello di codice una riga in modalità di modifica 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 della chiave primaria o i campi 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 corrispondenti 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 usare per eseguire un'azione personalizzata quando viene aggiornata una riga. Nella tabella seguente sono elencati gli eventi disponibili.

Event Descrizione
RowCancelingEdit Si verifica quando viene fatto clic sul pulsante Annulla della 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 viene fatto clic sul pulsante Modifica di una riga, ma prima che il controllo GridView passi alla modalità di modifica. Questo evento viene spesso usato per annullare l'operazione di modifica.
RowUpdated Si verifica quando viene fatto clic sul pulsante Aggiorna di una riga, ma dopo che il controllo GridView ha aggiornato la riga. Questo evento viene spesso usato per controllare i risultati dell'operazione di aggiornamento.
RowUpdating Si verifica quando viene fatto clic sul pulsante Aggiorna di una riga, ma prima che il controllo GridView aggiorni la riga. Questo evento viene spesso usato per annullare l'operazione di aggiornamento.

Si applica a

Vedi anche