DetailsView.AutoGenerateInsertButton Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol bawaan untuk menyisipkan rekaman baru ditampilkan dalam DetailsView kontrol.
public:
virtual property bool AutoGenerateInsertButton { bool get(); void set(bool value); };public virtual bool AutoGenerateInsertButton { get; set; }member this.AutoGenerateInsertButton : bool with get, setPublic Overridable Property AutoGenerateInsertButton As BooleanNilai Properti
true untuk menampilkan kontrol bawaan untuk menyisipkan rekaman baru; jika tidak, false. Defaultnya adalah false.
Contoh
Contoh kode berikut menunjukkan cara menggunakan AutoGenerateInsertButton properti untuk menampilkan kontrol bawaan untuk menyisipkan rekaman baru dalam DetailsView kontrol.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AutoGenerateInsertButton Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateinsertbutton="true"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the web.config file. -->
<asp:SqlDataSource ID="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country]
From [Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView AutoGenerateInsertButton Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>DetailsView AutoGenerateInsertButton Example</h3>
<asp:detailsview id="CustomerDetailView"
datasourceid="DetailsViewSource"
datakeynames="CustomerID"
autogenerateinsertbutton="true"
autogeneraterows="true"
allowpaging="true"
runat="server">
<headerstyle backcolor="Navy"
forecolor="White"/>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the web.config file. -->
<asp:SqlDataSource ID="DetailsViewSource" runat="server"
ConnectionString=
"<%$ ConnectionStrings:NorthWindConnectionString%>"
InsertCommand="INSERT INTO [Customers]([CustomerID],
[CompanyName], [Address], [City], [PostalCode], [Country])
VALUES (@CustomerID, @CompanyName, @Address, @City,
@PostalCode, @Country)"
SelectCommand="Select [CustomerID], [CompanyName],
[Address], [City], [PostalCode], [Country]
From [Customers]">
</asp:SqlDataSource>
</form>
</body>
</html>
Keterangan
Saat kontrol sumber data yang mendukung penyisipan terikat ke DetailsView kontrol, DetailsView kontrol dapat memanfaatkan kemampuan kontrol sumber data dan menyediakan fungsionalitas penyisipan otomatis.
Nota
Agar kontrol sumber data menyisipkan data, propertinya SqlDataSource.InsertCommand harus diatur dengan pernyataan sisipkan kueri.
AutoGenerateInsertButton Saat properti diatur ke true, CommandField bidang baris dengan tombol Baru secara otomatis ditampilkan dalam DetailsView kontrol. Mengklik tombol Baru menempatkan kontrol tersebut DetailsView dalam mode sisipkan. Saat dalam mode sisipkan, setiap bidang terikat dalam kontrol yang tidak baca-saja menampilkan kontrol input yang TextBox sesuai, seperti kontrol, untuk jenis data bidang. Ini memungkinkan pengguna untuk memasukkan nilai bidang untuk rekaman baru.
Saat diklik, tombol Baru juga diganti dengan tombol Sisipkan dan tombol Batal. Mengklik tombol Sisipkan menyisipkan rekaman baru di sumber data dan mengembalikan kontrol ke mode yang ditentukan oleh DefaultMode properti . Mengklik tombol Batal meninggalkan operasi sisipkan dan mengembalikan kontrol ke mode default.
Nota
Untuk meletakkan baris dalam mode sisipkan secara terprogram, gunakan ChangeMode metode .
Anda dapat mengontrol tampilan rekaman yang berada dalam mode sisipkan dengan menggunakan InsertRowStyle properti . Pengaturan umum biasanya mencakup warna latar belakang kustom, warna latar depan, dan properti font.
DetailsView Kontrol menyediakan beberapa peristiwa yang bisa Anda gunakan untuk melakukan tindakan kustom saat rekaman baru disisipkan. Tabel berikut mencantumkan peristiwa yang tersedia.
| Event | Deskripsi |
|---|---|
| ItemInserted | Terjadi saat tombol Sisipkan diklik, tetapi setelah DetailsView kontrol menyisipkan rekaman. Kejadian ini sering digunakan untuk memeriksa hasil operasi penyisipan. |
| ItemInserting | Terjadi saat tombol Sisipkan diklik, tetapi sebelum DetailsView kontrol menyisipkan rekaman. Kejadian ini sering digunakan untuk membatalkan operasi penyisipan. |
| ModeChanged | Terjadi setelah DetailsView kontrol berubah mode. |
| ModeChanging | Terjadi sebelum DetailsView kontrol berubah mode. Kejadian ini sering digunakan untuk membatalkan perubahan mode. |
Nilai AutoGenerateInsertButton disimpan dalam status tampilan.
