BoundField 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示数据绑定控件中以文本形式显示的字段。
public ref class BoundField : System::Web::UI::WebControls::DataControlField
public class BoundField : System.Web.UI.WebControls.DataControlField
type BoundField = class
inherit DataControlField
Public Class BoundField
Inherits DataControlField
- 继承
- 派生
示例
下面的代码示例演示如何使用 BoundField 对象在 控件中 GridView 显示字段的值。
<%@ 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>BoundField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:boundfield datafield="CustomerID"
readonly="true"
headertext="Customer ID"/>
<asp:boundfield datafield="CompanyName"
convertemptystringtonull="true"
headertext="Customer Name"/>
<asp:boundfield datafield="Address"
convertemptystringtonull="true"
headertext="Address"/>
<asp:boundfield datafield="City"
convertemptystringtonull="true"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
convertemptystringtonull="true"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
convertemptystringtonull="true"
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>BoundField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:boundfield datafield="CustomerID"
readonly="true"
headertext="Customer ID"/>
<asp:boundfield datafield="CompanyName"
convertemptystringtonull="true"
headertext="Customer Name"/>
<asp:boundfield datafield="Address"
convertemptystringtonull="true"
headertext="Address"/>
<asp:boundfield datafield="City"
convertemptystringtonull="true"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
convertemptystringtonull="true"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
convertemptystringtonull="true"
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>
注解
类 BoundField 由数据绑定控件 ((如 GridView 和 DetailsView) )用于将字段的值显示为文本。 对象的 BoundField 显示方式不同,具体取决于使用它的数据绑定控件。 例如, GridView 控件将对象显示为 BoundField 列,而 DetailsView 控件将其显示为一行。
若要指定要在 对象中显示的 BoundField 字段,请将 DataField 属性设置为字段的名称。 通过将 属性true
设置为 HtmlEncode ,字段的值可以在显示之前进行 HTML 编码。 可以通过设置 DataFormatString 属性将自定义格式字符串应用于字段的值。
HtmlEncode当 属性为 true
时,字段的编码字符串值用于自定义格式字符串。 默认情况下,仅当数据绑定控件处于只读模式时,格式设置字符串才应用于字段值。 若要将格式字符串应用于数据绑定控件处于编辑模式时显示的值,请将 ApplyFormatInEditMode 属性设置为 true
。 如果字段的值为 null,可以通过设置 NullDisplayText 属性来显示自定义标题。 对象 BoundField 还可以通过将 属性设置为 ConvertEmptyStringToNull ,自动将空字符串 (“”) 字段值转换为 true
null 值。
通过将 属性设置为 Visiblefalse
,可以在数据绑定控件中隐藏BoundField对象。 若要防止在编辑模式下修改字段的值,请将 ReadOnly 属性设置为 true
。 在支持插入记录 ((如DetailsView控件) )的数据绑定控件中,可以通过将 属性设置为 InsertVisible 来false
隐藏 BoundField 对象。 如果要在插入模式下隐藏自动生成的键字段,通常会执行此操作。
可以自定义 对象的页眉和页脚部分 BoundField 。 若要在页眉或页脚部分显示标题,请分别设置 HeaderText 或 FooterText 属性。 可以通过设置 HeaderImageUrl 属性来显示图像,而不是在页眉部分显示文本。 通过将 属性false
设置为 ShowHeader ,可以在 对象中BoundField隐藏标头部分。
注意
某些数据绑定控件 ((如 GridView 控件) )只能显示或隐藏控件的整个标头部分。 这些数据绑定控件不支持 ShowHeader 单个绑定字段的 属性。 若要显示或隐藏数据绑定控件 (的整个标头部分(如果可用) ),请使用 控件的 ShowHeader
属性。
还可以通过设置字段的不同部分的 BoundField 样式属性,自定义对象的外观 (字体颜色、背景色等) 。 下表列出了不同的样式属性。
Style 属性 | 说明 |
---|---|
ControlStyle | 对象的子 Web 服务器控件的 BoundField 样式设置。 |
FooterStyle | 对象的页脚部分的 BoundField 样式设置。 |
HeaderStyle | 对象的标头部分的 BoundField 样式设置。 |
ItemStyle | 对象中数据项的 BoundField 样式设置。 |
构造函数
BoundField() |
初始化 BoundField 类的新实例。 |
字段
ThisExpression |
此 API 支持产品基础结构,不能在代码中直接使用。 表示“this”表达式。 |
属性
AccessibleHeaderText |
获取或设置某些控件中呈现为 |
ApplyFormatInEditMode |
获取或设置一个值,该值指示包含 DataFormatString 对象的数据绑定控件处于编辑模式时,BoundField 属性指定的格式化字符串是否应用到字段值。 |
Control |
获取对数据控件的引用,该控件与 DataControlField 对象关联。 (继承自 DataControlField) |
ControlStyle |
获取 DataControlField 对象所包含的任何 Web 服务器控件的样式。 (继承自 DataControlField) |
ConvertEmptyStringToNull |
获取或设置一个值,该值指示在数据源中更新数据字段时是否将空字符串值 ("") 自动转换为 null 值。 |
DataField |
获取或设置要绑定到 BoundField 对象的数据字段的名称。 |
DataFormatString |
获取或设置字符串,该字符串指定字段值的显示格式。 |
DesignMode |
获取一个值,该值指示数据控件字段当前是否在设计时环境中进行查看。 (继承自 DataControlField) |
FooterStyle |
获取或设置数据控件字段脚注的样式。 (继承自 DataControlField) |
FooterText |
获取或设置数据控件字段的脚注项中显示的文本。 (继承自 DataControlField) |
HeaderImageUrl |
获取或设置数据控件字段的标题项中显示的图像的 URL。 (继承自 DataControlField) |
HeaderStyle |
获取或设置数据控件字段标头的样式。 (继承自 DataControlField) |
HeaderText |
获取或设置显示在数据控件标头中的文本。 |
HtmlEncode |
获取或设置一个值,该值指示在 BoundField 对象中显示字段值之前,是否对这些字段值进行 HTML 编码。 |
HtmlEncodeFormatString |
获取或设置一个值,该值指示通过将 DataFormatString 属性应用于 BoundField 值而创建的文本在显示时是否应经过 HTML 编码。 |
InsertVisible |
获取一个值,该值指示 DataControlField 对象在其父级数据绑定控件处于插入模式时是否可见。 (继承自 DataControlField) |
IsTrackingViewState |
获取一个值,该值指示 DataControlField 对象是否保存对其视图状态的更改。 (继承自 DataControlField) |
ItemStyle |
获取由数据控件字段显示的任何基于文本的内容的样式。 (继承自 DataControlField) |
NullDisplayText |
获取或设置当字段值为 null 时为字段显示的标题。 |
ReadOnly |
获取或设置一个值,该值指示是否可以在编辑模式中修改字段的值。 |
ShowHeader |
获取或设置一个值,该值指示是否呈现数据控件字段的标题项。 (继承自 DataControlField) |
SortExpression |
获取或设置数据源控件用来对数据进行排序的排序表达式。 (继承自 DataControlField) |
SupportsHtmlEncode |
获取一个值,该值指示 BoundField 对象是否支持 HTML 编码。 |
ValidateRequestMode |
获取或设置确定控件是否验证客户端输入的值。 |
ValidateRequestMode |
获取或设置一个值,该值指定该控件是否验证客户端输入。 (继承自 DataControlField) |
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) |