DataControlFieldCollection 类

定义

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

程序集:: System.Web.dll

重要

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

表示数据绑定控件（如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 属性指定集合中的项总数，通常用于确定集合的上限。可以使用 <a0/> 和方法向集合中添加和删除项。

如果使用GridView或控件，DataControlField则自动创建的对象（例如，属性为true时AutoGenerateColumns）不会存储在可公开访问的DetailsView字段集合中。只能访问和操作 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()	在派生类中重写时，获取集合可以包含的类型IStateManager StateManagedCollection数组。 (继承自 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.Add(Object)方法向集合中添加项之前IList.Insert(Int32, Object)执行其他工作。 (继承自 StateManagedCollection)
OnInsertComplete(Int32, Object)	在派生类中重写时，在或IList.Add(Object)方法向集合中添加项后IList.Insert(Int32, Object)执行其他工作。 (继承自 StateManagedCollection)
OnRemove(Int32, Object)	在派生类中重写时，在或IList.RemoveAt(Int32)方法从集合中删除指定项之前IList.Remove(Object)执行其他工作。 (继承自 StateManagedCollection)
OnRemoveComplete(Int32, Object)	在派生类中重写时，在或IList.RemoveAt(Int32)方法从集合中删除指定项后IList.Remove(Object)执行其他工作。 (继承自 StateManagedCollection)
OnValidate(Object)	在派生类中重写时，验证集合的 StateManagedCollection 元素。 (继承自 StateManagedCollection)
Remove(DataControlField)	从DataControlFieldCollection集合中删除指定的DataControlField对象。
RemoveAt(Int32)	从 DataControlField 集合中移除位于指定索引处的对象 DataControlFieldCollection 。
SetDirty()	强制整个 StateManagedCollection 集合序列化为视图状态。 (继承自 StateManagedCollection)
SetDirtyObject(Object)	在派生类中重写时，指示集合包含的一个 `object` 记录其整个状态以查看状态，而不是只记录更改信息。 (继承自 StateManagedCollection)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)

活动

名称	说明
FieldsChanged	在集合中的字段发生更改时发生，通常是作为方法调用的结果Clear()Remove(DataControlField)Insert(Int32, 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)

扩展方法

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

适用于

另请参阅

反馈

此页面是否有帮助？