BoundColumn 类

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

绑定到数据源中的字段的 DataGrid 控件的列类型。

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

继承: Object

DataGridColumn
BoundColumn

示例

以下示例演示如何使用 BoundColumn 控件中的 DataGrid 列类型来显示数据源中的字段。

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </script>
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

注解

BoundColumn使用控件中的DataGrid列类型在数据源中显示字段的内容。这些值在单个列中列出。字段链接到， BoundColumn因此数据源中的任何更新都将反映在控件的相应单元格中 DataGrid 。

注意

此列类型是控件的 DataGrid 默认值。

若要控制此列的外观，请使用控件的 DataGrid 样式属性。

注意

文本在显示在中 BoundColumn之前未进行 HTML 编码。这样就可以在文本的 HTML 标记中嵌入脚本。如果此列的值来自用户输入，请确保验证值以减少安全漏洞。

构造函数

BoundColumn()

初始化 BoundColumn 类的新实例。

字段

thisExpr

表示字符串“!”。此字段为只读。

属性

DataField	获取或设置要绑定到 BoundColumn 的数据源的字段名称。
DataFormatString	获取或设置指定列中各项的显示格式的字符串。
DesignMode	获取一个值，该值指示列是否处于设计模式。 (继承自 DataGridColumn)
FooterStyle	获取列的脚注部分的样式属性。 (继承自 DataGridColumn)
FooterText	获取或设置列的脚注部分中显示的文本。 (继承自 DataGridColumn)
HeaderImageUrl	获取或设置列的页眉节中显示的图像的位置。 (继承自 DataGridColumn)
HeaderStyle	获取列的页眉节的样式属性。 (继承自 DataGridColumn)
HeaderText	获取或设置在列的页眉节中显示的文本。 (继承自 DataGridColumn)
IsTrackingViewState	获取一个值，该值确定是否标记 DataGridColumn 对象以保存其状态。 (继承自 DataGridColumn)
ItemStyle	获取列的项单元格的样式属性。 (继承自 DataGridColumn)
Owner	获取列是其成员之一的 DataGrid 控件。 (继承自 DataGridColumn)
ReadOnly	获取或设置一个值，该值指示是否可编辑 BoundColumn 中的项。
SortExpression	获取或设置选择进行排序的列时传递到 OnSortCommand(DataGridSortCommandEventArgs) 方法的字段或表达式的名称。 (继承自 DataGridColumn)
ViewState	获取 StateBag 对象，它允许从 DataGridColumn 类派生的列存储其属性。 (继承自 DataGridColumn)
Visible	获取或设置一个值，该值指示此列在 DataGrid 控件中是否可见。 (继承自 DataGridColumn)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FormatDataValue(Object)	将指定的值转换为 DataFormatString 属性指示的格式。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
Initialize()	将 BoundColumn 重置为其初始状态。
InitializeCell(TableCell, Int32, ListItemType)	将 BoundColumn 中的指定单元格重置为其初始状态。
LoadViewState(Object)	加载 DataGridColumn 对象的状态。 (继承自 DataGridColumn)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnColumnChanged()	调用 OnColumnsChanged() 方法。 (继承自 DataGridColumn)
SaveViewState()	保存 DataGridColumn 对象的当前状态。 (继承自 DataGridColumn)
ToString()	返回列的字符串表示形式。 (继承自 DataGridColumn)
TrackViewState()	导致跟踪服务器控件的视图状态的更改，以便这些更改可以存储到服务器控件的 StateBag 对象中。 (继承自 DataGridColumn)

显式接口实现

IStateManager.IsTrackingViewState	获取一个值，该值指示该列是否跟踪视图状态更改。 (继承自 DataGridColumn)
IStateManager.LoadViewState(Object)	加载以前保存的状态。 (继承自 DataGridColumn)
IStateManager.SaveViewState()	返回包含状态更改的对象。 (继承自 DataGridColumn)
IStateManager.TrackViewState()	开始跟踪状态更改。 (继承自 DataGridColumn)

适用于

通过

BoundColumn 类

定义

示例

注解

构造函数

字段

属性

方法

显式接口实现

适用于

另请参阅

其他资源