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- 继承
示例
下面的代码示例演示如何使用CheckBoxField控件中的GridView对象显示具有布尔数据类型的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 属性来显示每个复选框旁边的标题。 A CheckBoxField object is hidden in a data-bound control when the Visible property is set to false. 若要防止在编辑模式下修改字段的值，请将 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) |