CheckBoxField 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示在資料繫結控制項中顯示為核取方塊的布林值欄位。
public ref class CheckBoxField : System::Web::UI::WebControls::BoundFieldpublic class CheckBoxField : System.Web.UI.WebControls.BoundFieldtype CheckBoxField = class
inherit BoundFieldPublic Class CheckBoxField
Inherits BoundField- 繼承
範例
下列程式碼範例示範如何使用 控制項中的 GridView 物件，以布林 CheckBoxField 值資料類型顯示來自Microsoft SQL Server資料來源的欄位。
<%@ 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>
備註
資料 CheckBoxField 繫結控制項會使用 類別 (，例如 GridView 和 DetailsView) ，在核取方塊中顯示布林值資料欄位的值。 根據所使用的資料繫結控制項，物件 CheckBoxField 會以不同的方式顯示。 例如， GridView 控制項會將物件顯示為 CheckBoxField 資料行，而 DetailsView 控制項則會將其顯示為數據列。
注意
停用核取方塊 (唯讀) ，直到資料繫結控制項在編輯模式中顯示包含核取方塊的記錄為止。 如需如何將記錄放入編輯模式的詳細資訊，請參閱包含 CheckBoxField 物件的父控制項檔。
若要指定要顯示在 物件中的 CheckBoxField 欄位，請使用功能變數名稱設定 DataField 屬性。
注意
因為核取方塊只能顯示選取或未選取的狀態， CheckBoxField 所以物件只能系結至具有布林資料類型的欄位，或可由 剖析的 Parse 字串。
您可以藉由設定 Text 屬性，在每個核取方塊旁邊顯示標題。 CheckBoxField當 屬性設定 false 為 時， Visible 物件會在資料繫結控制項中隱藏。 若要防止欄位的值在編輯模式中修改，請將 ReadOnly 屬性設定為 true 。 在支援插入記錄的資料繫結控制項中， (例如 DetailsView 控制項) ，您可以將 屬性設定 InsertVisible 為 false ，在插入模式中隱藏 CheckBoxField 物件。
您可以自訂 物件的頁首和頁尾區段 CheckBoxField 。 若要在頁首或頁尾區段中顯示標題，請分別設定 HeaderText 或 FooterText 屬性。 您可以藉由設定 HeaderImageUrl 屬性來顯示影像，而不是在標頭區段中顯示文字。 您可以將 屬性設定 ShowHeader 為 false ，以隱藏 物件中的 CheckBoxField 標頭區段。
注意
某些資料繫結控制項 (，例如 GridView 控制項) 只能顯示或隱藏控制項的整個標頭區段。 這些資料繫結控制項不支援 ShowHeader 個別綁定欄位的 屬性。 若要顯示或隱藏資料繫結控制項的整個標頭區段，如果) 可用，請使用 控制項的 ShowHeader 屬性 (。
您也可以藉由設定欄位不同部分的 CheckBoxField 樣式屬性，自訂物件的外觀 (字型色彩、背景色彩等等) 。 下表列出不同的樣式屬性。
| Style 屬性 | 描述 |
|---|---|
| ControlStyle | 物件的子 Web 服務器控制項樣式 CheckBoxField 設定。 |
| FooterStyle | 物件的頁尾區段樣式 CheckBoxField 設定。 |
| HeaderStyle | 物件的標頭區段樣式 CheckBoxField 設定。 |
| ItemStyle | 物件中資料項目的 CheckBoxField 樣式設定。 |
建構函式
| CheckBoxField() |
初始化 CheckBoxField 類別的新執行個體。 |
屬性
| AccessibleHeaderText |
取得或設定在部分控制項中呈現為 |
| ApplyFormatInEditMode |
覆寫 ApplyFormatInEditMode 屬性。 CheckBoxField 類別不支援這個屬性。 |
| Control |
取得與 DataControlField 物件關聯之資料控制項的參考。 (繼承來源 DataControlField) |
| ControlStyle |
取得 DataControlField 物件內含之任何 Web 伺服器控制項的樣式。 (繼承來源 DataControlField) |
| ConvertEmptyStringToNull |
覆寫 ConvertEmptyStringToNull 屬性。 CheckBoxField 類別不支援這個屬性。 |
| DataField |
取得或設定要繫結至 CheckBoxField 物件之資料欄位的名稱。 |
| DataFormatString |
取得或設定字串，指定欄位值的顯示格式。 CheckBoxField 類別不支援這個屬性。 |
| DesignMode |
取得值，指示目前是否在設計階段環境中檢視資料控制項欄位。 (繼承來源 DataControlField) |
| FooterStyle |
取得或設定資料控制項欄位的頁尾樣式。 (繼承來源 DataControlField) |
| FooterText |
取得或設定顯示在資料控制項欄位之頁尾項目中的文字。 (繼承來源 DataControlField) |
| HeaderImageUrl |
取得或設定顯示在資料控制項欄位的標頭項目中之影像的 URL。 (繼承來源 DataControlField) |
| HeaderStyle |
取得或設定資料控制項欄位的標頭樣式。 (繼承來源 DataControlField) |
| HeaderText |
取得或設定顯示在資料控制項標頭中的文字。 (繼承來源 BoundField) |
| HtmlEncode |
覆寫 HtmlEncode 屬性。 CheckBoxField 類別不支援這個屬性。 |
| HtmlEncodeFormatString |
取得或設定值，這個值表示格式化文字在顯示之前是否應該先經過 HTML 編碼。 |
| InsertVisible |
取得值，指示 DataControlField 物件在其父資料繫結控制項處於插入模式時是否可見。 (繼承來源 DataControlField) |
| IsTrackingViewState |
取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField) |
| ItemStyle |
取得由資料控制項欄位顯示之任何文字基礎內容的樣式。 (繼承來源 DataControlField) |
| NullDisplayText |
取得或設定欄位值為 |
| ReadOnly |
取得或設定值，表示是否可以在編輯模式下修改欄位值。 (繼承來源 BoundField) |
| ShowHeader |
取得或設定值，指示是否呈現資料控制項欄位的標頭項目。 (繼承來源 DataControlField) |
| SortExpression |
取得或設定資料來源控制項用於排序資料的排序運算式。 (繼承來源 DataControlField) |
| SupportsHtmlEncode |
取得布林值，表示控制項是否支援 HTML 編碼。 |
| Text |
取得或設定要在 CheckBoxField 物件中每個核取方塊旁邊顯示的標題。 |
| ValidateRequestMode |
取得或設定值，決定控制項是否驗證用戶端輸入。 (繼承來源 BoundField) |
| ViewState |
取得狀態資訊的字典，允許您在相同頁面的多個要求之間，儲存和還原 DataControlField 物件的檢視狀態。 (繼承來源 DataControlField) |
| Visible |
取得或設定值，指示是否呈現資料控制項欄位。 (繼承來源 DataControlField) |
方法
明確介面實作
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
取得或設定與此 DataControlField 物件相關聯的結構描述。 (繼承來源 DataControlField) |
| IStateManager.IsTrackingViewState |
取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField) |
| IStateManager.LoadViewState(Object) |
將資料控制項欄位還原成先前儲存的檢視狀態。 (繼承來源 DataControlField) |
| IStateManager.SaveViewState() |
儲存自頁面回傳至伺服器以來對 DataControlField 檢視狀態所做的變更。 (繼承來源 DataControlField) |
| IStateManager.TrackViewState() |
會造成 DataControlField 物件追蹤其檢視狀態變更，以將這些變更儲存在控制項的 ViewState 屬性中，並持續存取相同頁面的其他要求。 (繼承來源 DataControlField) |