IObservableCollection<T>¶

实现接口: System.Collections.Generic.IEnumerable<T>，System.Collections.IEnumerable，System.Collections.Generic.IReadOnlyCollection<T>

类型参数

• T — 元素类型（字典集合为 KeyValuePair{TKey,TValue}）。

声明¶

public interface IObservableCollection<T> : System.Collections.Generic.IEnumerable<T>, 
System.Collections.IEnumerable, 
System.Collections.Generic.IReadOnlyCollection<T> 

可观察集合契约：单一变更事件的订阅与退订。

备注

由 ObservableList{T} / ObservableDictionary{TKey, TValue} / ObservableHashSet{T} 统一实现。 变更通知为单轨事件（内部由 MiniEvent{T} 承载）：无变更的写操作不通知 （索引器赋相同值、Remove 不存在的元素、Clear 空集合等）；批量操作逐项通知； Sort / Reverse / Clear 以 Reset 通知（无附加字段）。

AddListener 返回 AutoRemoveListenerHandle， 可用 using 语句在作用域结束时自动移除，或经 RemoveListenerExtensions 绑定到 Unity 生命周期（OnDestroy / OnDisable / 场景卸载）自动清理。

集合内部不加锁，不做任何线程同步——与框架整体边界一致，仅约定主线程使用。

方法¶

AddListener(Action<CollectionChangedEventArgs>)¶

添加集合变更监听者。回调参数为本次变更（见 CollectionChangedEventArgs{T} 的字段约定）。

public abstract AutoRemoveListenerHandle AddListener(Action<CollectionChangedEventArgs<T>> callback)

参数

返回值

ClearListeners()¶

清空所有变更监听。

备注

清除全部监听引用，防止因监听者未释放导致的内存泄漏。 与清空元素的方法（Clear）不同——本方法清除的是监听者而非集合内容。 供持有只读接口的 View / Presenter 在对象池对象归还前统一摘除全部监听： 实现类型均为 sealed，无法经继承补出该能力，只读接口暴露本成员是"只持有接口"场景下的唯一入口。

public abstract void ClearListeners()

RemoveListener(Action<CollectionChangedEventArgs>)¶

移除集合变更监听者。

public abstract void RemoveListener(Action<CollectionChangedEventArgs<T>> callback)

参数

Additional Notes¶

首个 ## Additional Notes 是增量生成文档标识符，请勿修改标题级别和内容！本文档由 Script Doc Generator 辅助生成。