Bagikan melalui

DetailsView.AutoGenerateEditButton Properti

Definisi

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

Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol bawaan untuk mengedit rekaman saat ini ditampilkan dalam DetailsView 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 menampilkan kontrol bawaan untuk mengedit rekaman saat ini; jika tidak, false. Defaultnya adalah false.

Contoh

Contoh kode berikut menunjukkan cara menggunakan AutoGenerateEditButton properti untuk menampilkan kontrol bawaan untuk mengedit rekaman saat ini.


<%@ 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 AutoGenerateEditButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateEditButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="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 AutoGenerateEditButton Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView AutoGenerateEditButton Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="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 pembaruan terikat ke DetailsView kontrol, DetailsView kontrol dapat memanfaatkan kemampuan kontrol sumber data dan menyediakan fungsionalitas pembaruan otomatis.

Nota

Agar kontrol sumber data memperbarui data, propertinya SqlDataSource.UpdateCommand harus diatur dengan pernyataan kueri pembaruan.

AutoGenerateEditButton Saat properti diatur ke true, CommandField bidang baris dengan tombol Edit secara otomatis ditampilkan dalam DetailsView kontrol. Mengklik tombol Edit menempatkan kontrol tersebut DetailsView dalam mode edit. Saat dalam mode edit, 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 mengubah nilai bidang.

Saat diklik, tombol Edit juga diganti dengan tombol Perbarui dan tombol Batalkan. Mengklik tombol Perbarui memperbarui rekaman di sumber data dengan perubahan nilai apa pun dan mengembalikan kontrol ke mode yang ditentukan oleh DefaultMode properti . Mengklik tombol Batal meninggalkan perubahan nilai apa pun dan mengembalikan kontrol ke mode default.

Nota

Untuk menempatkan DetailsView kontrol dalam mode edit secara terprogram, gunakan ChangeMode metode .

AutoGenerateRows Ketika properti juga diatur ke true, DetailsView kontrol secara otomatis memastikan bahwa bidang atau bidang yang ditentukan dalam DataKeyNames properti bersifat baca-saja.

Nota

Kecuali Anda menerapkan fungsionalitas pembaruan Anda sendiri, Anda harus mengatur DataKeyNames properti agar fitur pembaruan otomatis berfungsi.

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

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

Event Deskripsi
ItemUpdated Terjadi saat tombol Perbarui diklik, tetapi setelah DetailsView kontrol memperbarui rekaman. Kejadian ini sering digunakan untuk memeriksa hasil operasi pembaruan.
ItemUpdating Terjadi saat tombol Perbarui diklik, tetapi sebelum DetailsView kontrol memperbarui rekaman. Kejadian ini sering digunakan untuk membatalkan operasi pembaruan.
ModeChanged Terjadi setelah DetailsView kontrol berubah mode.
ModeChanging Terjadi sebelum DetailsView kontrol berubah mode. Kejadian ini sering digunakan untuk membatalkan perubahan mode.

Nilai AutoGenerateEditButton disimpan dalam status tampilan.

Berlaku untuk

Lihat juga