CheckBoxField Kelas

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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.

Mewakili bidang Boolean yang ditampilkan sebagai kotak centang dalam kontrol terikat data.

public ref class CheckBoxField : System::Web::UI::WebControls::BoundField

public class CheckBoxField : System.Web.UI.WebControls.BoundField

type CheckBoxField = class
    inherit BoundField

Public Class CheckBoxField
Inherits BoundField

Warisan: Object

DataControlField

BoundField
CheckBoxField

Contoh

Contoh kode berikut menunjukkan cara menggunakan CheckBoxField objek dalam GridView kontrol untuk menampilkan bidang dari sumber data Microsoft SQL Server dengan jenis data Boolean.


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

      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
                    
          <asp:checkboxfield datafield="contract"
            text="Contract"
            headertext="Contract"/>     
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        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>CheckBoxField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>CheckBoxField Example</h3>

      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
                    
          <asp:checkboxfield datafield="contract"
            text="Contract"
            headertext="Contract"/>     
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Keterangan

Kelas CheckBoxField digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan nilai bidang data Boolean dalam kotak centang. Objek CheckBoxField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat objek digunakan. Misalnya, GridView kontrol menampilkan CheckBoxField objek sebagai kolom, sementara DetailsView kontrol menampilkannya sebagai baris.

Nota

Kotak centang dinonaktifkan (baca-saja) hingga kontrol terikat data menampilkan rekaman yang berisi kotak centang dalam mode edit. Untuk informasi selengkapnya tentang cara memasukkan rekaman ke mode edit, lihat dokumentasi untuk kontrol induk yang berisi CheckBoxField objek.

Untuk menentukan bidang yang akan ditampilkan dalam CheckBoxField objek, atur DataField properti dengan nama bidang.

Nota

Karena kotak centang hanya dapat menampilkan status yang dipilih atau tidak dipilih, CheckBoxField objek hanya dapat diikat ke bidang dengan tipe data Boolean atau string yang dapat diurai oleh Parse.

Anda bisa menampilkan keterangan di samping setiap kotak centang dengan mengatur Text properti . Objek CheckBoxField disembunyikan dalam kontrol terikat data saat Visible properti diatur ke false. Untuk mencegah nilai bidang dimodifikasi dalam mode edit, atur properti ke ReadOnlytrue. Dalam kontrol terikat data yang mendukung penyisipan rekaman (seperti DetailsView kontrol), Anda bisa menyembunyikan CheckBoxField objek dalam mode sisipkan dengan mengatur InsertVisible properti ke false.

Anda dapat mengkustomisasi CheckBoxField bagian header dan footer objek. Untuk menampilkan keterangan di bagian header atau footer, atur HeaderText properti atau FooterText . Alih-alih menampilkan teks di bagian header, Anda bisa menampilkan gambar dengan mengatur HeaderImageUrl properti . Bagian header dapat disembunyikan dalam CheckBoxField objek dengan mengatur ShowHeader properti ke false.

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 terikat individual. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data (jika tersedia), gunakan properti kontrol ShowHeader .

Anda juga dapat menyesuaikan tampilan CheckBoxField 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 CheckBoxField .
FooterStyle	Pengaturan gaya untuk bagian CheckBoxField footer objek.
HeaderStyle	Pengaturan gaya untuk bagian CheckBoxField header objek.
ItemStyle	Pengaturan gaya untuk item data dalam CheckBoxField objek.

Konstruktor

Nama	Deskripsi
CheckBoxField()	Menginisialisasi instans baru dari kelas CheckBoxField.

Properti

Nama	Deskripsi
AccessibleHeaderText	Mendapatkan atau mengatur teks yang dirender sebagai `AbbreviatedText` nilai properti dalam beberapa kontrol. (Diperoleh dari DataControlField)
ApplyFormatInEditMode	Mengambil alih ApplyFormatInEditMode properti. Properti ini tidak didukung oleh CheckBoxField kelas .
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)
ConvertEmptyStringToNull	Mengambil alih ConvertEmptyStringToNull properti. Properti ini tidak didukung oleh CheckBoxField kelas .
DataField	Mendapatkan atau mengatur nama bidang data yang akan diikat ke CheckBoxField objek.
DataFormatString	Mendapatkan atau mengatur string yang menentukan format tampilan untuk nilai bidang. Properti ini tidak didukung oleh CheckBoxField kelas .
DesignMode	Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain. (Diperoleh dari DataControlField)
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 header kontrol data. (Diperoleh dari BoundField)
HtmlEncode	Mengambil alih HtmlEncode properti. Properti ini tidak didukung oleh CheckBoxField kelas .
HtmlEncodeFormatString	Mendapatkan atau menetapkan nilai yang menunjukkan apakah teks yang diformat harus dikodekan HTML sebelum ditampilkan.
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)
NullDisplayText	Mendapatkan atau mengatur teks yang ditampilkan untuk bidang saat nilai bidang adalah `null`. Properti ini tidak didukung oleh CheckBoxField kelas .
ReadOnly	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang dapat dimodifikasi dalam mode edit. (Diperoleh dari BoundField)
ShowHeader	Mendapatkan atau mengatur nilai yang menunjukkan apakah item header bidang kontrol data dirender. (Diperoleh dari DataControlField)
SortExpression	Mendapatkan atau mengatur ekspresi pengurutan yang digunakan oleh kontrol sumber data untuk mengurutkan data. (Diperoleh dari DataControlField)
SupportsHtmlEncode	Mendapatkan nilai Boolean yang menunjukkan apakah kontrol mendukung pengodean HTML.
Text	Mendapatkan atau mengatur keterangan untuk ditampilkan di samping setiap kotak centang dalam CheckBoxField objek.
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien atau tidak. (Diperoleh dari BoundField)
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 CheckBoxField ke objek yang ditentukan DataControlField .
CreateField()	Membuat objek kosong CheckBoxField .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Mengisi objek yang ditentukan IDictionary dengan nilai dari objek yang ditentukan DataControlFieldCell .
FormatDataValue(Object, Boolean)	Memformat nilai bidang yang ditentukan untuk sel dalam BoundField objek. (Diperoleh dari BoundField)
GetDesignTimeValue()	Mengambil nilai yang digunakan untuk nilai bidang saat merender CheckBoxField objek dalam perancang.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(Control)	Mengambil nilai bidang yang terikat ke BoundField objek. (Diperoleh dari BoundField)
Initialize(Boolean, Control)	Menginisialisasi objek BoundField. (Diperoleh dari BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Menginisialisasi objek yang ditentukan TableCell ke status baris yang ditentukan. (Diperoleh dari BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Menginisialisasi objek yang ditentukan DataControlFieldCell ke status baris yang ditentukan.
LoadViewState(Object)	Memulihkan informasi status tampilan yang disimpan sebelumnya untuk bidang ini. (Diperoleh dari BoundField)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnDataBindField(Object, EventArgs)	Mengikat nilai bidang ke kotak centang dalam CheckBoxField objek.
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 CheckBoxField 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

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

CheckBoxField Kelas

Definisi

Contoh

Keterangan

Konstruktor

Properti

Metode

Implementasi Antarmuka Eksplisit

Berlaku untuk

Lihat juga

Saran dan Komentar