表示一个动态数据集合,在添加项、移除项或刷新整个列表时,此集合将提供通知。
System.Collections.ObjectModel.Collection<T>
System.Collections.ObjectModel.ObservableCollection<T>
System.Data.Services.Client.DataServiceCollection<T>
System.Windows.Controls.CalendarBlackoutDatesCollection
System.Windows.Controls.GridViewColumnCollection
System.Windows.Controls.SelectedDatesCollection
程序集: System(在 System.dll 中)
用于 XAML 的 XMLNS:未映射到 xmlns。
ObservableCollection<T> 类型公开以下成员。
名称 | 说明 | |
---|---|---|
![]() | ObservableCollection<T>() | 初始化 ObservableCollection<T> 类的新实例。 |
![]() | ObservableCollection<T>(IEnumerable<T>) | 初始化 ObservableCollection<T> 类的新实例,该类包含从指定集合中复制的元素。 |
![]() | ObservableCollection<T>(List<T>) | 初始化 ObservableCollection<T> 类的新实例,该类包含从指定列表中复制的元素。 |
名称 | 说明 | |
---|---|---|
![]() | Count | 获取 Collection<T> 中实际包含的元素数。 (继承自 Collection<T>。) |
![]() | Item | 获取或设置指定索引处的元素。 (继承自 Collection<T>。) |
![]() | Items | 获取 Collection<T> 周围的 IList<T> 包装。 (继承自 Collection<T>。) |
名称 | 说明 | |
---|---|---|
![]() ![]() | ICollection.CopyTo | 从特定的 Array 索引处开始,将 ICollection 的元素复制到一个 Array 中。 (继承自 Collection<T>。) |
![]() ![]() | ICollection<T>.IsReadOnly | 获取一个值,该值指示 ICollection<T> 是否为只读。 (继承自 Collection<T>。) |
![]() ![]() | ICollection.IsSynchronized | 获取一个值,该值指示是否同步对 ICollection 的访问(线程安全)。 (继承自 Collection<T>。) |
![]() ![]() | ICollection.SyncRoot | 获取可用于同步对 ICollection 的访问的对象。 (继承自 Collection<T>。) |
![]() ![]() | IEnumerable.GetEnumerator | 返回一个循环访问集合的枚举数。 (继承自 Collection<T>。) |
![]() ![]() | IList.Add | 将某项添加到 IList 中。 (继承自 Collection<T>。) |
![]() ![]() | IList.Contains | 确定 IList 是否包含特定值。 (继承自 Collection<T>。) |
![]() ![]() | IList.IndexOf | 确定 IList 中特定项的索引。 (继承自 Collection<T>。) |
![]() ![]() | IList.Insert | 将某项插入 IList 中指定的索引处。 (继承自 Collection<T>。) |
![]() ![]() | IList.IsFixedSize | 获取一个值,该值指示 IList 是否具有固定大小。 (继承自 Collection<T>。) |
![]() ![]() | IList.IsReadOnly | 获取一个值,该值指示 IList 是否为只读。 (继承自 Collection<T>。) |
![]() ![]() | IList.Item | 获取或设置指定索引处的元素。 (继承自 Collection<T>。) |
![]() ![]() | IList.Remove | 从 IList 中移除特定对象的第一个匹配项。 (继承自 Collection<T>。) |
![]() ![]() | INotifyPropertyChanged.PropertyChanged | 在更改属性值时发生。 |
在许多情况下,所使用的数据是对象的集合。例如,数据绑定中的一个常见方案是使用 ItemsControl(如 ListBox、ListView 或 TreeView)来显示记录的集合。
可以枚举实现 IEnumerable 接口的任何集合。但是,若要设置动态绑定,以使集合中的插入或移除操作可以自动更新 UI,则该集合必须实现 INotifyCollectionChanged 接口。此接口公开 CollectionChanged 事件,只要基础集合发生更改,都应该引发该事件。
WPF 提供 ObservableCollection<T> 类,它是实现 INotifyCollectionChanged 接口的数据集合的内置实现。
在实现自己的集合之前,请先考虑使用 ObservableCollection<T> 或现有的集合类之一,如 List<T>、Collection<T> 和 BindingList<T> 等。如果有高级方案并且希望实现自己的集合,请考虑使用 IList,它提供可以通过索引逐个访问的对象的非泛型集合。如果实现 IList,则将使用数据绑定引擎提供最佳性能。
![]() |
---|
为了完全支持将绑定源对象中的数据值传送到绑定目标,在支持可绑定属性的集合中的每个对象都必须实现适当的属性更改通知机制,如 INotifyPropertyChanged 接口。 |
有关更多信息,请参见数据绑定概述中的“绑定到集合”。
关于 XAML 用法的说明
ObservableCollection<T> 可在 Windows Presentation Foundation (WPF) 3.0 和 3.5 版本中的一个 XAML 对象元素使用。但是,使用情况有众多限制。
-
ObservableCollection<T> 必须是根元素,因为指定泛型 ObservableCollection<T> 的约束类型所必须使用的 x:TypeArguments 特性只在根元素的对象元素上受支持。
-
您必须声明一个 x:Class 特性(此属性要求该 XAML 文件的生成操作必须是 Page 或某种编译 XAML 的其他生成操作)。
-
ObservableCollection<T> 所在的命名空间和程序集最初未映射到默认的 XML 命名空间。您必须为该命名空间和程序集映射一个前缀,然后在 ObservableCollection<T> 的对象元素标记上使用该前缀。
在应用程序中使用 XAML 的 ObservableCollection<T> 功能的一种更直接的方法是声明自己的非泛型自定义集合类,该类派生自 ObservableCollection<T> 并将其约束为特定类型。然后映射包含此类的程序集,并将其作为 XAML 中的对象元素进行引用。
This example shows how to create and bind to a collection that derives from the ObservableCollection<T> class, which is a collection class that provides notifications when items get added or removed.
The following example shows the implementation of a NameList collection:
You can make the collection available for binding the same way you would with other common language runtime (CLR) objects, as described in 如何:使数据可用于 XAML 中的绑定. For example, you can instantiate the collection in XAML and specify the collection as a resource, as shown here:
You can then bind to the collection: