BoundField 类

定义

表示数据绑定控件中以文本形式显示的字段。

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 由数据绑定控件 ((如 GridViewDetailsView) )用于将字段的值显示为文本。 对象的 BoundField 显示方式不同,具体取决于使用它的数据绑定控件。 例如, GridView 控件将对象显示为 BoundField 列,而 DetailsView 控件将其显示为一行。

若要指定要在 对象中显示的 BoundField 字段,请将 DataField 属性设置为字段的名称。 通过将 属性true设置为 HtmlEncode ,字段的值可以在显示之前进行 HTML 编码。 可以通过设置 DataFormatString 属性将自定义格式字符串应用于字段的值。 HtmlEncode当 属性为 true时,字段的编码字符串值用于自定义格式字符串。 默认情况下,仅当数据绑定控件处于只读模式时,格式设置字符串才应用于字段值。 若要将格式字符串应用于数据绑定控件处于编辑模式时显示的值,请将 ApplyFormatInEditMode 属性设置为 true。 如果字段的值为 null,可以通过设置 NullDisplayText 属性来显示自定义标题。 对象 BoundField 还可以通过将 属性设置为 ConvertEmptyStringToNull ,自动将空字符串 (“”) 字段值转换为 truenull 值。

通过将 属性设置为 Visiblefalse,可以在数据绑定控件中隐藏BoundField对象。 若要防止在编辑模式下修改字段的值,请将 ReadOnly 属性设置为 true。 在支持插入记录 ((如DetailsView控件) )的数据绑定控件中,可以通过将 属性设置为 InsertVisiblefalse隐藏 BoundField 对象。 如果要在插入模式下隐藏自动生成的键字段,通常会执行此操作。

可以自定义 对象的页眉和页脚部分 BoundField 。 若要在页眉或页脚部分显示标题,请分别设置 HeaderTextFooterText 属性。 可以通过设置 HeaderImageUrl 属性来显示图像,而不是在页眉部分显示文本。 通过将 属性false设置为 ShowHeader ,可以在 对象中BoundField隐藏标头部分。

注意

某些数据绑定控件 ((如 GridView 控件) )只能显示或隐藏控件的整个标头部分。 这些数据绑定控件不支持 ShowHeader 单个绑定字段的 属性。 若要显示或隐藏数据绑定控件 (的整个标头部分(如果可用) ),请使用 控件的 ShowHeader 属性。

还可以通过设置字段的不同部分的 BoundField 样式属性,自定义对象的外观 (字体颜色、背景色等) 。 下表列出了不同的样式属性。

Style 属性 说明
ControlStyle 对象的子 Web 服务器控件的 BoundField 样式设置。
FooterStyle 对象的页脚部分的 BoundField 样式设置。
HeaderStyle 对象的标头部分的 BoundField 样式设置。
ItemStyle 对象中数据项的 BoundField 样式设置。

构造函数

BoundField()

初始化 BoundField 类的新实例。

字段

ThisExpression

此 API 支持产品基础结构,不能在代码中直接使用。

表示“this”表达式。

属性

AccessibleHeaderText

获取或设置某些控件中呈现为 AbbreviatedText 属性值的文本。

(继承自 DataControlField)
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)

方法

CloneField()

创建当前 DataControlField 派生对象的副本。

(继承自 DataControlField)
CopyProperties(DataControlField)

将当前 BoundField 对象的属性复制到指定的 DataControlField 对象。

CreateField()

创建一个空的 BoundField 对象。

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

使用指定的 IDictionary 对象中的值填充指定的 TableCell 对象。

FormatDataValue(Object, Boolean)

设定 BoundField 对象内的单元格中的指定字段值。

GetDesignTimeValue()

在设计器中呈现 BoundField 对象时,检索用作字段值的值。

GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
GetValue(Control)

检索绑定到 BoundField 对象的字段值。

Initialize(Boolean, Control)

初始化 BoundField 对象。

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

将指定的 TableCell 对象初始化为指定的行状态。

InitializeDataCell(DataControlFieldCell, DataControlRowState)

将指定的 TableCell 对象初始化为指定的行状态。

LoadViewState(Object)

还原以前为此字段存储的视图状态信息。

MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
OnDataBindField(Object, EventArgs)

将字段值绑定到 BoundField 对象。

OnFieldChanged()

引发 FieldChanged 事件。

(继承自 DataControlField)
SaveViewState()

保存在页回发到服务器后对 DataControlField 视图状态所做的更改。

(继承自 DataControlField)
ToString()

返回表示此 DataControlField 对象的字符串。

(继承自 DataControlField)
TrackViewState()

使 DataControlField 对象跟踪对其视图状态所做的更改,以便这些更改可以存储在控件的 ViewState 属性中并且能够在同一页的不同请求间得以保持。

(继承自 DataControlField)
ValidateSupportsCallback()

确定包含在 BoundField 对象中的控件是否支持回调。

显式接口实现

IDataSourceViewSchemaAccessor.DataSourceViewSchema

获取或设置与此 DataControlField 对象关联的架构。

(继承自 DataControlField)
IStateManager.IsTrackingViewState

获取一个值,该值指示 DataControlField 对象是否保存对其视图状态的更改。

(继承自 DataControlField)
IStateManager.LoadViewState(Object)

将数据控件字段还原为保存过的前一视图状态。

(继承自 DataControlField)
IStateManager.SaveViewState()

保存在页回发到服务器后对 DataControlField 视图状态所做的更改。

(继承自 DataControlField)
IStateManager.TrackViewState()

使 DataControlField 对象跟踪对其视图状态所做的更改,以便这些更改可以存储在控件的 ViewState 属性中并且能够在同一页的不同请求间得以保持。

(继承自 DataControlField)

适用于

另请参阅