DataControlFieldCollection 类

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

表示数据绑定控件（如 GridView 和 DetailsView）使用的 DataControlField 对象的集合。

public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollection

public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection

type DataControlFieldCollection = class
    inherit StateManagedCollection

Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection

继承

Object

StateManagedCollection

DataControlFieldCollection

注解

该 DataControlFieldCollection 类表示数据绑定控件用来指定其子控件呈现方式的对象集合 DataControlField 。 该 DataControlFieldCollection 类派生自 StateManagedCollection一个抽象基集合类，用于存储 IStateManager 对象。

对象 StateManagedCollection 会影响对象的行为 DataControlFieldCollection 。 DataControlField 在还原状态时，动态添加到集合中的对象将重新添加到控件。 这意味着，字段需要仅添加、删除或更改一次，而不是在每个回发上，因为 ASP.NET 中的大多数集合类型都需要。

(类DataControlField实现IStateManager接口，使接口能够以 ASP.NET 视图状态存储其状态。 )

使用 DataControlFieldCollection 类以编程方式管理一组 DataControlField 对象。 请注意，声明性地定义这些字段更为常见。

可以使用类的DataControlFieldCollection相应方法添加、插入和删除DataControlField对象。 若要以编程方式从集合检索 DataControlField 对象，请使用以下方法之一：

• 使用索引器使用数组表示法从集合中获取单个 DataControlField 对象。

• GetEnumerator使用该方法创建一个System.Collections.IEnumerator实现的对象，然后可以使用该对象从集合中获取项。

该 Count 属性指定集合中的项总数，通常用于确定集合的上限。 You can add items to and remove items from the collection using the Add, Insert, Remove, and RemoveAt methods.

如果使用GridView或控件，DataControlField则 (自动创建的对象（例如，当属性true) 未存储在可公开访问的字段集合中时AutoGenerateColumnsDetailsView）。 只能访问和操作 DataControlField 未自动生成的对象。

下表列出了不同的数据控制字段类及其使用方式。

Parameter 类	说明
DataControlField	所有字段的抽象基类。
BoundField	一个数据绑定控件字段，用于绑定到从 ASP.NET 数据源控件检索到的文本或数据。
ButtonFieldBase	封装常规按钮功能的数据绑定控件字段。 ButtonField 并 CheckBoxField 派生自它。
ButtonField	显示至少一个按钮的数据绑定控件字段。
CheckBoxField	显示 CheckBox 控件的数据绑定控件字段。
CommandField	一个数据绑定控件字段，用于显示可对行 (或列) 显示的数据执行的操作，例如编辑、更新或删除。
HyperLinkField	显示 HyperLink 控件的数据绑定控件字段。
ImageField	显示 Image 控件的数据绑定控件字段。
TemplateField	数据绑定控件字段，用于在数据绑定控件中显示自定义内容。

构造函数

DataControlFieldCollection()

初始化 DataControlFieldCollection 类的新实例。

属性

Count	获取 StateManagedCollection 集合中包含的元素的数量。 (继承自 StateManagedCollection)
Item[Int32]	获取或设置集合中指定索引处的 DataControlField 对象。

方法

Add(DataControlField)	将指定的 DataControlField 对象追加到集合末尾。
Clear()	从 StateManagedCollection 集合中删除所有项。 (继承自 StateManagedCollection)
CloneFields()	创建当前集合的副本。
Contains(DataControlField)	确定 DataControlFieldCollection 集合中是否包含特定的 DataControlField 对象。
CopyTo(Array, Int32)	从特定的数组索引开始，将 StateManagedCollection 集合的元素复制到数组中。 (继承自 StateManagedCollection)
CopyTo(DataControlField[], Int32)	从目标数组的指定索引处开始，将整个 DataControlFieldCollection 集合复制到兼容的一维 Array。
CreateKnownType(Int32)	在派生类中替代时，创建实现 IStateManager 的类的实例。 所创建对象的类型基于由 GetKnownTypes() 方法返回的集合的指定成员。 (继承自 StateManagedCollection)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回循环访问 StateManagedCollection 集合的迭代器。 (继承自 StateManagedCollection)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetKnownTypes()	在派生类中替代时，获取 StateManagedCollection 集合可以包含的 IStateManager 类型的数组。 (继承自 StateManagedCollection)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(DataControlField)	确定集合中特定 DataControlField 对象的索引。
Insert(Int32, DataControlField)	将指定的 DataControlField 对象插入到 DataControlFieldCollection 集合中的指定索引位置。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnClear()	在派生类中替代时，在 Clear() 方法从集合中删除所有项之前执行附加工作。 (继承自 StateManagedCollection)
OnClearComplete()	在派生类中替代时，在 Clear() 方法完成从集合中删除所有项之后执行附加工作。 (继承自 StateManagedCollection)
OnInsert(Int32, Object)	在派生类中替代时，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法向集合中添加项之前执行附加工作。 (继承自 StateManagedCollection)
OnInsertComplete(Int32, Object)	在派生类中替代时，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法向集合中添加项之后执行附加工作。 (继承自 StateManagedCollection)
OnRemove(Int32, Object)	在派生类中替代时，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法从集合中删除指定项之前执行附加工作。 (继承自 StateManagedCollection)
OnRemoveComplete(Int32, Object)	在派生类中替代时，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法从集合中删除指定项之后执行附加工作。 (继承自 StateManagedCollection)
OnValidate(Object)	在派生类中替代时，验证 StateManagedCollection 集合的一个元素。 (继承自 StateManagedCollection)
Remove(DataControlField)	从 DataControlField 集合中移除指定的 DataControlFieldCollection 对象。
RemoveAt(Int32)	移除 DataControlField 集合中指定索引处的 DataControlFieldCollection 对象。
SetDirty()	强制将整个 StateManagedCollection 集合序列化为视图状态。 (继承自 StateManagedCollection)
SetDirtyObject(Object)	在派生类中替代时，指示集合包含的 object 将其全部状态记录到视图状态，而不是仅记录更改信息。 (继承自 StateManagedCollection)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

FieldsChanged

这种情况发生在集合中的字段更改时，通常是由于 Clear()、Insert(Int32, DataControlField)、Remove(DataControlField) 或 Add(DataControlField) 方法调用的结果。 在集合中的 DataControlField 引发 FieldChanged 事件的任何时候，也会引发此事件。

显式接口实现

ICollection.Count	获取 StateManagedCollection 集合中包含的元素的数量。 (继承自 StateManagedCollection)
ICollection.IsSynchronized	获取指示 StateManagedCollection 集合是否已同步(线程安全)的值。 此方法在所有情况下均返回 false。 (继承自 StateManagedCollection)
ICollection.SyncRoot	获取可用于同步对 StateManagedCollection 集合的访问的对象。 此方法在所有情况下均返回 null。 (继承自 StateManagedCollection)
IEnumerable.GetEnumerator()	返回循环访问 StateManagedCollection 集合的迭代器。 (继承自 StateManagedCollection)
IList.Add(Object)	向 StateManagedCollection 集合中添加一个项。 (继承自 StateManagedCollection)
IList.Clear()	从 StateManagedCollection 集合中删除所有项。 (继承自 StateManagedCollection)
IList.Contains(Object)	确定 StateManagedCollection 集合中是否包含特定值。 (继承自 StateManagedCollection)
IList.IndexOf(Object)	确定 StateManagedCollection 集合中的指定项的索引。 (继承自 StateManagedCollection)
IList.Insert(Int32, Object)	将项在指定索引处插入 StateManagedCollection 集合中。 (继承自 StateManagedCollection)
IList.IsFixedSize	获取指示 StateManagedCollection 集合是否具有固定大小的值。 此方法在所有情况下均返回 false。 (继承自 StateManagedCollection)
IList.IsReadOnly	获取指示 StateManagedCollection 集合是否为只读的值。 (继承自 StateManagedCollection)
IList.Item[Int32]	获取指定索引处的 IStateManager 元素。 (继承自 StateManagedCollection)
IList.Remove(Object)	从 StateManagedCollection 集合中删除指定对象的第一个匹配项。 (继承自 StateManagedCollection)
IList.RemoveAt(Int32)	删除指定索引处的 IStateManager 元素。 (继承自 StateManagedCollection)
IStateManager.IsTrackingViewState	获取指示 StateManagedCollection 集合是否保存对其视图状态的更改的值。 (继承自 StateManagedCollection)
IStateManager.LoadViewState(Object)	还原 StateManagedCollection 集合以及其包含的 IStateManager 项的以前保存的视图状态。 (继承自 StateManagedCollection)
IStateManager.SaveViewState()	保存自页回发到服务器后对 StateManagedCollection 集合和该集合包含的每个 IStateManager 对象所做的更改。 (继承自 StateManagedCollection)
IStateManager.TrackViewState()	使 StateManagedCollection 集合及其包含的每个 IStateManager 对象跟踪对它们的视图状态所做的更改，以使它们可以在相同页的请求之间得以保持。 (继承自 StateManagedCollection)

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

另请参阅

• DataControlField
• GridView
• DetailsView