CheckBoxField Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Veriye bağlı denetimde onay kutusu olarak görüntülenen Boole alanını temsil eder.

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

Devralma: Object

DataControlField

BoundField
CheckBoxField

Örnekler

Aşağıdaki kod örneği, boole veri türüne sahip bir CheckBoxField GridView Microsoft SQL Server veri kaynağından alan görüntülemek için denetimdeki bir nesnenin nasıl kullanılacağını gösterir.


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

Açıklamalar

sınıfı CheckBoxField , veriye bağlı denetimler (ve gibi GridView DetailsView) tarafından boole veri alanının değerini bir onay kutusunda görüntülemek için kullanılır. Nesne CheckBoxField , kullanıldığı veriye bağlı denetime bağlı olarak farklı şekilde görüntülenir. Örneğin, GridView denetim bir CheckBoxField nesneyi sütun olarak görüntülerken DetailsView , denetim bunu satır olarak görüntüler.

Not

Veriye bağlı denetim, onay kutusunu içeren bir kaydı düzenleme modunda görüntüleyene kadar onay kutusu devre dışı bırakılır (salt okunur). Kaydı düzenleme moduna yerleştirme hakkında daha fazla bilgi için, nesneyi içeren üst denetimin belgelerine CheckBoxField bakın.

Nesnede CheckBoxField görüntülenecek alanı belirtmek için, özelliğini alanın adıyla ayarlayın DataField .

Not

Onay kutusu yalnızca seçili veya seçilmemiş bir durumu görüntüleyebileceğinden, nesne CheckBoxField yalnızca Boole veri türüne veya tarafından Parseayrıştırılabilir dizeye sahip bir alana bağlanabilir.

Özelliğini ayarlayarak Text her onay kutusunun yanında bir resim yazısı görüntüleyebilirsiniz. CheckBoxField Özelliği olarak ayarlandığında bir nesne veriye bağlı denetimde gizlenir Visible false. Bir alanın değerinin düzenleme modunda değiştirilmesini önlemek için özelliğini olarak trueayarlayınReadOnly. Kayıt eklemeyi destekleyen veriye bağlı denetimlerde (denetim gibiDetailsView), özelliğini falseolarak ayarlayarak InsertVisible ekleme modunda bir CheckBoxField nesneyi gizleyebilirsiniz.

Bir nesnenin üst bilgi ve alt bilgi bölümlerini CheckBoxField özelleştirebilirsiniz. Üst bilgi veya alt bilgi bölümlerinde resim yazısı görüntülemek için sırasıyla veya FooterText özelliklerini ayarlayınHeaderText. Üst bilgi bölümünde metin görüntülemek yerine, özelliğini ayarlayarak HeaderImageUrl bir görüntü görüntüleyebilirsiniz. üst bilgi bölümü, özelliği falseolarak ayarlanarak nesnede CheckBoxField gizlenebilirShowHeader.

Not

Bazı veriye bağlı denetimler (denetim gibi) denetimin GridView yalnızca üst bilgi bölümünün tamamını gösterebilir veya gizleyebilir. Bu veriye bağlı denetimler, tek bir ilişkili alanın özelliğini desteklemez ShowHeader . Veriye bağlı denetimin üst bilgi bölümünün tamamını göstermek veya gizlemek için (varsa), denetimin ShowHeader özelliğini kullanın.

Ayrıca, alanın farklı bölümleri için stil özelliklerini ayarlayarak nesnenin CheckBoxField görünümünü (yazı tipi rengi, arka plan rengi vb.) özelleştirebilirsiniz. Aşağıdaki tabloda farklı stil özellikleri listeılmıştır.

Style özelliği	Description
ControlStyle	Nesnenin alt Web sunucusu denetimleri CheckBoxField için stil ayarları.
FooterStyle	Nesnenin alt bilgi bölümünün CheckBoxField stil ayarları.
HeaderStyle	Nesnenin üst bilgi bölümünün CheckBoxField stil ayarları.
ItemStyle	Nesnedeki veri öğelerinin CheckBoxField stil ayarları.

Oluşturucular

CheckBoxField()

CheckBoxField sınıfının yeni bir örneğini başlatır.

Özellikler

AccessibleHeaderText	Bazı denetimlerde özellik değeri olarak `AbbreviatedText` işlenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
ApplyFormatInEditMode	ApplyFormatInEditMode özelliğini geçersiz kılar. Bu özellik sınıfı tarafından CheckBoxField desteklenmiyor.
Control	Nesnenin ilişkili olduğu veri denetimine DataControlField başvuru alır. (Devralındığı yer: DataControlField)
ControlStyle	Nesnenin içerdiği DataControlField web sunucusu denetimlerinin stilini alır. (Devralındığı yer: DataControlField)
ConvertEmptyStringToNull	ConvertEmptyStringToNull özelliğini geçersiz kılar. Bu özellik sınıfı tarafından CheckBoxField desteklenmiyor.
DataField	Nesneye bağlanacak CheckBoxField veri alanının adını alır veya ayarlar.
DataFormatString	Alanın değeri için görüntüleme biçimini belirten dizeyi alır veya ayarlar. Bu özellik sınıfı tarafından CheckBoxField desteklenmiyor.
DesignMode	Bir veri denetim alanının şu anda bir tasarım zamanı ortamında görüntülenip görüntülenmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
FooterStyle	Veri denetim alanının alt bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
FooterText	Veri denetim alanının alt bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderImageUrl	Bir veri denetimi alanının üst bilgi öğesinde görüntülenen görüntünün URL'sini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderStyle	Veri denetim alanının üst bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderText	Veri denetiminin üst bilgisinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: BoundField)
HtmlEncode	HtmlEncode özelliğini geçersiz kılar. Bu özellik sınıfı tarafından CheckBoxField desteklenmiyor.
HtmlEncodeFormatString	Biçimlendirilmiş metnin görüntülenmeden önce HTML kodlanmış olması gerekip gerekmediğini belirten bir değer alır veya ayarlar.
InsertVisible	Üst veri bağlı denetimi ekleme modundayken nesnenin DataControlField görünür olup olmadığını belirten bir değer alır. (Devralındığı yer: DataControlField)
IsTrackingViewState	Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
ItemStyle	Veri denetim alanı tarafından görüntülenen metin tabanlı içeriğin stilini alır. (Devralındığı yer: DataControlField)
NullDisplayText	Alanın değeri olduğunda `null`alan için görüntülenen metni alır veya ayarlar. Bu özellik sınıfı tarafından CheckBoxField desteklenmiyor.
ReadOnly	Alanın değerinin düzenleme modunda değiştirilip değiştirilemeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: BoundField)
ShowHeader	Veri denetim alanının üst bilgi öğesinin işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)
SortExpression	Verileri sıralamak için veri kaynağı denetimi tarafından kullanılan bir sıralama ifadesi alır veya ayarlar. (Devralındığı yer: DataControlField)
SupportsHtmlEncode	Denetimin HTML kodlamasını destekleyip desteklemediğini belirten bir Boole değeri alır.
Text	Resim yazısını nesnedeki CheckBoxField her onay kutusunun yanında görüntülenecek şekilde alır veya ayarlar.
ValidateRequestMode	Denetimin istemci girişini doğrulayıp doğrulamadığını belirleyen bir değer alır veya ayarlar. (Devralındığı yer: BoundField)
ViewState	Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenizi ve geri yüklemenizi sağlayan durum DataControlField bilgileri sözlüğü alır. (Devralındığı yer: DataControlField)
Visible	Veri denetim alanının işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)

Yöntemler

CloneField()	Geçerli DataControlFieldtüretilmiş nesnenin yinelenen bir kopyasını oluşturur. (Devralındığı yer: DataControlField)
CopyProperties(DataControlField)	Geçerli CheckBoxField nesnenin özelliklerini belirtilen DataControlField nesneye kopyalar.
CreateField()	Boş CheckBoxField bir nesne oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Belirtilen nesneyi belirtilen IDictionary nesnedeki DataControlFieldCell değerlerle doldurur.
FormatDataValue(Object, Boolean)	Nesnedeki bir hücre için belirtilen alan değerini biçimlendirin BoundField . (Devralındığı yer: BoundField)
GetDesignTimeValue()	Tasarımcıda nesneyi işlerken CheckBoxField alanın değeri için kullanılan değeri alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetValue(Control)	Nesneye bağlı BoundField alanın değerini alır. (Devralındığı yer: BoundField)
Initialize(Boolean, Control)	BoundField Nesnesini başlatır. (Devralındığı yer: BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Belirtilen nesneyi belirtilen TableCell satır durumuna başlatır. (Devralındığı yer: BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Belirtilen nesneyi belirtilen DataControlFieldCell satır durumuna başlatır.
LoadViewState(Object)	Bu alan için önceden depolanan görünüm durumu bilgilerini geri yükler. (Devralındığı yer: BoundField)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDataBindField(Object, EventArgs)	Bir alanın değerini nesnedeki bir onay kutusuna CheckBoxField bağlar.
OnFieldChanged()	Olayı tetikler `FieldChanged` . (Devralındığı yer: DataControlField)
SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
ToString()	Bu DataControlField nesneyi temsil eden bir dize döndürür. (Devralındığı yer: DataControlField)
TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)
ValidateSupportsCallback()	Bir CheckBoxField nesnedeki denetimlerin geri çağırmaları destekleyip desteklemediğini belirler.

Belirtik Arabirim Kullanımları

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Bu DataControlField nesneyle ilişkili şemayı alır veya ayarlar. (Devralındığı yer: DataControlField)
IStateManager.IsTrackingViewState	Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
IStateManager.LoadViewState(Object)	Veri denetimi alanının daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
IStateManager.SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
IStateManager.TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)

Şunlara uygulanır