Bagikan melalui

GridView.AutoGenerateEditButton Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur nilai yang menunjukkan apakah CommandField kolom bidang dengan tombol Edit untuk setiap baris data secara otomatis ditambahkan ke GridView kontrol.

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

Nilai Properti

Boolean

true untuk menambahkan CommandField kolom bidang secara otomatis dengan tombol Edit untuk setiap baris data; jika tidak, false. Defaultnya adalah false.

Contoh

Contoh berikut menunjukkan cara menggunakan AutoGenerateEditButton properti untuk mengaktifkan fitur GridView pengeditan otomatis kontrol.

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

Keterangan

Saat kontrol sumber data yang mendukung pembaruan terikat ke GridView kontrol, GridView kontrol dapat memanfaatkan kemampuan kontrol sumber data dan menyediakan fungsionalitas pembaruan otomatis.

Nota

Agar kontrol sumber data memperbarui data, kontrol sumber data harus dikonfigurasi untuk memperbarui data. Untuk mengonfigurasi kontrol sumber data untuk memperbarui rekaman, lihat dokumentasi untuk kontrol sumber data tertentu.

AutoGenerateEditButton Saat properti diatur ke true, kolom (diwakili oleh CommandField objek) dengan tombol Edit untuk setiap baris data secara otomatis ditambahkan ke GridView kontrol. Mengklik tombol Edit untuk baris menempatkan baris tersebut dalam mode edit. Saat baris dalam mode edit, setiap bidang kolom dalam baris yang tidak baca-saja menampilkan kontrol input yang TextBox sesuai, seperti kontrol, untuk jenis data bidang. Ini memungkinkan pengguna untuk mengubah nilai bidang.

Saat diklik, tombol Edit juga diganti dengan tombol Perbarui dan tombol Batalkan. Mengklik tombol Perbarui memperbarui baris di sumber data dengan perubahan nilai apa pun dan mengembalikan baris untuk menampilkan mode. Mengklik tombol Batal meninggalkan perubahan nilai apa pun dan mengembalikan baris untuk menampilkan mode.

Nota

Anda dapat secara terprogram menempatkan baris dalam mode edit dengan mengatur EditIndex properti dengan indeks baris. Untuk keluar dari mode edit secara terprogram, atur EditIndex properti ke -1.

Saat menggunakan fungsionalitas pembaruan bawaan, Anda harus mengatur DataKeyNames properti dengan daftar nama bidang yang dipisahkan koma untuk mengidentifikasi bidang kunci utama atau bidang sumber data; jika tidak, fungsionalitas pembaruan bawaan tidak akan dapat memperbarui rekaman yang benar. Saat menggunakan kolom bidang yang dihasilkan secara otomatis (dengan mengatur AutoGenerateColumns properti ke true), GridView kontrol secara otomatis memastikan bahwa kolom bidang yang dihasilkan secara otomatis yang sesuai dengan bidang atau bidang yang ditentukan dalam DataKeyNames properti bersifat baca-saja.

Anda dapat mengontrol tampilan baris yang berada dalam mode edit dengan menggunakan EditRowStyle properti . Pengaturan umum biasanya mencakup warna latar belakang kustom, warna latar depan, dan properti font.

Kontrol GridView menyediakan beberapa peristiwa yang dapat Anda gunakan untuk melakukan tindakan kustom saat baris diperbarui. Tabel berikut mencantumkan peristiwa yang tersedia.

Event Deskripsi
RowCancelingEdit Terjadi ketika tombol Batalkan baris diklik, tetapi sebelum GridView kontrol membatalkan mode edit. Kejadian ini sering digunakan untuk menghentikan operasi pembatalan.
RowEditing Terjadi saat tombol Edit baris diklik, tetapi sebelum GridView kontrol memasuki mode edit. Kejadian ini sering digunakan untuk membatalkan operasi pengeditan.
RowUpdated Terjadi saat tombol Perbarui baris diklik, tetapi setelah GridView kontrol memperbarui baris. Kejadian ini sering digunakan untuk memeriksa hasil operasi pembaruan.
RowUpdating Terjadi saat tombol Perbarui baris diklik, tetapi sebelum GridView kontrol memperbarui baris. Kejadian ini sering digunakan untuk membatalkan operasi pembaruan.

Berlaku untuk

Lihat juga