Bagikan melalui


CommandField Kelas

Definisi

Mewakili bidang khusus yang menampilkan tombol perintah untuk melakukan pemilihan, pengeditan, penyisipan, atau penghapusan operasi dalam kontrol terikat data.

public ref class CommandField : System::Web::UI::WebControls::ButtonFieldBase
public class CommandField : System.Web.UI.WebControls.ButtonFieldBase
type CommandField = class
    inherit ButtonFieldBase
Public Class CommandField
Inherits ButtonFieldBase
Warisan

Contoh

Contoh kode berikut menunjukkan cara menggunakan CommandField bidang untuk menampilkan kontrol untuk mengedit rekaman dalam GridView 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Contoh kode berikut menunjukkan cara menggunakan CancelTextproperti , , EditTextdan UpdateText untuk mengkustomisasi teks untuk kontrol pengeditan.


<%@ 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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </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>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">
      
      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">
        
        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>
        
      </asp:gridview>
            
      <!-- 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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Keterangan

Kelas CommandField adalah bidang khusus yang digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan tombol perintah yang melakukan operasi hapus, edit, sisipkan, atau pilih. Tombol perintah untuk melakukan operasi ini dapat ditampilkan atau disembunyikan menggunakan properti yang diperlihatkan dalam tabel berikut.

Harta benda Deskripsi
ShowDeleteButton Memperlihatkan atau menyembunyikan tombol Hapus di CommandField bidang untuk setiap rekaman dalam kontrol terikat data. Tombol Hapus memungkinkan pengguna menghapus rekaman dari sumber data.
ShowEditButton Memperlihatkan atau menyembunyikan tombol Edit di CommandField bidang untuk setiap rekaman dalam kontrol terikat data. Tombol Edit memungkinkan pengguna mengedit rekaman dari sumber data. Saat pengguna mengklik tombol Edit untuk rekaman tertentu, tombol Edit tersebut diganti dengan tombol Perbarui dan tombol Batal. Semua tombol perintah lainnya juga disembunyikan.
ShowInsertButton Memperlihatkan atau menyembunyikan tombol Baru dalam bidang CommandField . Tombol Baru memungkinkan pengguna menyisipkan rekaman baru di sumber data. Ketika pengguna mengklik tombol Baru, tombol ini diganti dengan tombol Sisipkan dan tombol Batal. Semua tombol perintah lainnya juga disembunyikan. Catatan: Properti ini hanya berlaku untuk kontrol terikat data yang mendukung operasi penyisipan, seperti DetailsView kontrol.
ShowSelectButton Memperlihatkan atau menyembunyikan tombol Pilih di CommandField bidang untuk setiap rekaman dalam kontrol terikat data. Tombol Pilih memungkinkan pengguna untuk memilih rekaman di kontrol terikat data.

Selain itu, tombol Batal ditampilkan saat rekaman dalam mode edit atau sisipkan dapat ditampilkan atau disembunyikan dengan mengatur ShowCancelButton properti .

Nota

Saat kontrol terikat data digunakan dalam kombinasi dengan kontrol sumber data (seperti SqlDataSource kontrol), kontrol terikat data dapat memanfaatkan kemampuan kontrol sumber data dan menyediakan fungsionalitas penghapusan, pembaruan, dan sisipkan otomatis. Untuk sumber data lainnya, Anda perlu menyediakan rutinitas untuk melakukan operasi ini selama peristiwa yang sesuai untuk kontrol terikat data.

Bidang CommandField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat bidang digunakan. Misalnya, GridView kontrol menampilkan CommandField bidang sebagai kolom, sementara DetailsView kontrol menampilkannya sebagai baris.

Untuk menentukan jenis tombol yang akan ditampilkan, gunakan ButtonType properti . ButtonType Saat properti diatur ke ButtonType.Button atau ButtonType.Link, Anda dapat menentukan teks yang akan ditampilkan untuk tombol dengan mengatur properti yang diperlihatkan dalam tabel berikut.

Harta benda Deskripsi
CancelText Keterangan untuk tombol Batalkan.
DeleteText Keterangan untuk tombol Hapus.
EditText Keterangan untuk tombol Edit.
InsertText Keterangan untuk tombol Sisipkan. Catatan: Properti ini hanya berlaku untuk kontrol terikat data yang mendukung operasi penyisipan, seperti DetailsView kontrol.
NewText Keterangan untuk tombol Baru. Catatan: Properti ini hanya berlaku untuk kontrol terikat data yang mendukung operasi penyisipan, seperti DetailsView kontrol.
SelectText Keterangan untuk tombol Pilih.
UpdateText Keterangan untuk tombol Perbarui.

Alih-alih menampilkan tombol perintah atau tombol tautan, Anda bisa menampilkan tombol gambar dengan mengatur ButtonType properti ke ButtonType.Image lalu mengatur properti yang diperlihatkan dalam tabel berikut.

Harta benda Deskripsi
CancelImageUrl Gambar yang akan ditampilkan untuk tombol Batalkan
DeleteImageUrl Gambar yang akan ditampilkan untuk tombol Hapus.
EditImageUrl Gambar yang akan ditampilkan untuk tombol Edit.
InsertText Gambar yang ditampilkan untuk tombol Sisipkan. Catatan: Properti ini hanya berlaku untuk kontrol terikat data yang mendukung operasi penyisipan, seperti DetailsView kontrol.
NewImageUrl Gambar yang akan ditampilkan untuk tombol Baru. Catatan: Properti ini hanya berlaku untuk kontrol terikat data yang mendukung operasi penyisipan, seperti DetailsView kontrol.
SelectImageUrl Gambar yang akan ditampilkan untuk tombol Pilih.
UpdateImageUrl Gambar yang ditampilkan untuk tombol Perbarui.

Secara default, ketika pengguna mengklik tombol di CommandField bidang, validasi dilakukan pada semua kontrol validasi pada halaman. Untuk mencegah validasi terjadi ketika tombol diklik, atur properti ke CausesValidationfalse.

Anda dapat menyembunyikan CommandField bidang dalam kontrol terikat data dengan mengatur Visible properti ke false.

Bidang ini CommandField memungkinkan Anda mengkustomisasi bagian header dan footernya. Untuk menampilkan keterangan di header atau bagian footer, atur HeaderText properti atau FooterText . Alih-alih menampilkan teks di bagian header, Anda bisa menampilkan gambar dengan mengatur HeaderImageUrl properti . Untuk menyembunyikan bagian header dalam CommandField objek, atur properti ke ShowHeaderfalse.

Nota

Beberapa kontrol terikat data (seperti GridView kontrol) hanya dapat menampilkan atau menyembunyikan seluruh bagian header kontrol. Kontrol terikat data ini tidak mendukung ShowHeader properti untuk bidang tombol individual. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data (jika tersedia), gunakan properti kontrol ShowHeader .

Anda juga dapat menyesuaikan tampilan CommandField objek (warna font, warna latar belakang, dan sebagainya) dengan mengatur properti gaya untuk berbagai bagian bidang. Tabel berikut ini mencantumkan properti gaya yang berbeda.

Properti gaya Deskripsi
ControlStyle Pengaturan gaya untuk kontrol server Web anak objek CommandField .
FooterStyle Pengaturan gaya untuk bagian CommandField footer objek.
HeaderStyle Pengaturan gaya untuk bagian CommandField header objek.
ItemStyle Pengaturan gaya untuk item data dalam CommandField objek.

Konstruktor

Nama Deskripsi
CommandField()

Menginisialisasi instans baru dari kelas CommandField.

Properti

Nama Deskripsi
AccessibleHeaderText

Mendapatkan atau mengatur teks yang dirender sebagai AbbreviatedText nilai properti dalam beberapa kontrol.

(Diperoleh dari DataControlField)
ButtonType

Mendapatkan atau mengatur jenis tombol untuk ditampilkan di bidang tombol.

(Diperoleh dari ButtonFieldBase)
CancelImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Batalkan di CommandField bidang.

CancelText

Mendapatkan atau mengatur keterangan untuk tombol Batalkan yang ditampilkan di CommandField bidang.

CausesValidation

Mendapatkan atau menetapkan nilai yang menunjukkan apakah validasi dilakukan saat pengguna mengklik tombol di CommandField bidang.

Control

Mendapatkan referensi ke kontrol data yang DataControlField terkait dengan objek.

(Diperoleh dari DataControlField)
ControlStyle

Mendapatkan gaya kontrol server Web apa pun yang terkandung oleh DataControlField objek.

(Diperoleh dari DataControlField)
DeleteImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Hapus di CommandField bidang.

DeleteText

Mendapatkan atau mengatur keterangan untuk tombol Hapus di CommandField bidang.

DesignMode

Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain.

(Diperoleh dari DataControlField)
EditImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Edit di CommandField bidang.

EditText

Mendapatkan atau mengatur keterangan untuk tombol Edit di CommandField bidang.

FooterStyle

Mendapatkan atau mengatur gaya footer bidang kontrol data.

(Diperoleh dari DataControlField)
FooterText

Mendapatkan atau mengatur teks yang ditampilkan dalam item footer bidang kontrol data.

(Diperoleh dari DataControlField)
HeaderImageUrl

Mendapatkan atau mengatur URL gambar yang ditampilkan di item header bidang kontrol data.

(Diperoleh dari DataControlField)
HeaderStyle

Mendapatkan atau mengatur gaya header bidang kontrol data.

(Diperoleh dari DataControlField)
HeaderText

Mendapatkan atau mengatur teks yang ditampilkan di item header bidang kontrol data.

(Diperoleh dari DataControlField)
InsertImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Sisipkan di CommandField bidang.

InsertText

Mendapatkan atau mengatur keterangan untuk tombol Sisipkan di CommandField bidang.

InsertVisible

Mendapatkan nilai yang menunjukkan apakah DataControlField objek terlihat ketika kontrol terikat data induknya berada dalam mode sisipkan.

(Diperoleh dari DataControlField)
IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya.

(Diperoleh dari DataControlField)
ItemStyle

Mendapatkan gaya konten berbasis teks apa pun yang ditampilkan oleh bidang kontrol data.

(Diperoleh dari DataControlField)
NewImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Baru di CommandField bidang.

NewText

Mendapatkan atau mengatur keterangan untuk tombol Baru dalam bidang CommandField .

SelectImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Pilih di CommandField bidang.

SelectText

Mendapatkan atau mengatur keterangan untuk tombol Pilih di CommandField bidang.

ShowCancelButton

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Batal ditampilkan di CommandField bidang.

ShowDeleteButton

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Hapus ditampilkan di CommandField bidang.

ShowEditButton

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Edit ditampilkan di CommandField bidang.

ShowHeader

Mendapatkan atau mengatur nilai yang menunjukkan apakah bagian header ditampilkan dalam ButtonFieldBase objek.

(Diperoleh dari ButtonFieldBase)
ShowInsertButton

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Baru ditampilkan di CommandField bidang.

ShowSelectButton

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Pilih ditampilkan di CommandField bidang.

SortExpression

Mendapatkan atau mengatur ekspresi pengurutan yang digunakan oleh kontrol sumber data untuk mengurutkan data.

(Diperoleh dari DataControlField)
UpdateImageUrl

Mendapatkan atau mengatur URL ke gambar yang akan ditampilkan untuk tombol Perbarui di CommandField bidang.

UpdateText

Mendapatkan atau mengatur keterangan untuk tombol Perbarui di CommandField bidang.

ValidateRequestMode

Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien.

(Diperoleh dari DataControlField)
ValidationGroup

Mendapatkan atau mengatur nama grup kontrol validasi untuk divalidasi saat tombol dalam objek diklik ButtonFieldBase .

(Diperoleh dari ButtonFieldBase)
ViewState

Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataControlField tampilan objek di beberapa permintaan untuk halaman yang sama.

(Diperoleh dari DataControlField)
Visible

Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang kontrol data dirender.

(Diperoleh dari DataControlField)

Metode

Nama Deskripsi
CloneField()

Membuat salinan duplikat dari objek -turunan saat ini DataControlField.

(Diperoleh dari DataControlField)
CopyProperties(DataControlField)

Menyalin properti objek saat ini CommandField ke objek yang ditentukan DataControlField .

CreateField()

Membuat objek kosong CommandField .

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Mengekstrak nilai bidang kontrol data dari sel tabel saat ini dan menambahkan nilai ke koleksi yang ditentukan IDictionary .

(Diperoleh dari DataControlField)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
Initialize(Boolean, Control)

Melakukan inisialisasi instans dasar untuk bidang kontrol data.

(Diperoleh dari DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Menginisialisasi objek yang ditentukan DataControlFieldCell ke status baris yang ditentukan.

LoadViewState(Object)

Memulihkan status tampilan sumber data yang sebelumnya disimpan.

(Diperoleh dari DataControlField)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
OnFieldChanged()

Menaikkan FieldChanged acara.

(Diperoleh dari DataControlField)
SaveViewState()

Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server.

(Diperoleh dari DataControlField)
ToString()

Mengembalikan string yang mewakili objek ini DataControlField .

(Diperoleh dari DataControlField)
TrackViewState()

DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama.

(Diperoleh dari DataControlField)
ValidateSupportsCallback()

Menentukan apakah kontrol yang terkandung dalam CommandField panggilan balik dukungan objek.

Implementasi Antarmuka Eksplisit

Nama Deskripsi
IDataSourceViewSchemaAccessor.DataSourceViewSchema

Mendapatkan atau mengatur skema yang terkait dengan objek ini DataControlField .

(Diperoleh dari DataControlField)
IStateManager.IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya.

(Diperoleh dari DataControlField)
IStateManager.LoadViewState(Object)

Memulihkan status tampilan yang disimpan sebelumnya di bidang kontrol data.

(Diperoleh dari DataControlField)
IStateManager.SaveViewState()

Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server.

(Diperoleh dari DataControlField)
IStateManager.TrackViewState()

DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama.

(Diperoleh dari DataControlField)

Berlaku untuk

Lihat juga