WeakEventManager.ListenerList.PrepareForWriting 方法

定义

重要

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

检查是否正在使用提供的列表，如果正在使用，则将列表引用参数设置为该列表的副本，而不是原稿列表的副本。

public:
 static bool PrepareForWriting(System::Windows::WeakEventManager::ListenerList ^ % list);

public static bool PrepareForWriting (ref System.Windows.WeakEventManager.ListenerList list);

static member PrepareForWriting : ListenerList -> bool

Public Shared Function PrepareForWriting (ByRef list As WeakEventManager.ListenerList) As Boolean

要检查其使用状态和可能副本的列表。

Boolean

如果调用时正在使用提供的列表，并因此 list 参数引用被重置为副本，则为 true。如果未使用提供的列表，在此情况下 list 参数引用保持不变，则为 false。

如果给定列表正在使用 (这意味着当前正在) 传递事件，则调用此方法会将输入 list 替换为克隆。现有用户将完成将事件传送到原始列表，而不会受到对新列表的更改的干扰。

如果方法返回 true，则调用方可能需要在自己的数据结构中插入新列表，因为这表示所提供的列表可能不再为最新列表。

此方法在内部调用 BeginUse ，然后立即调用 EndUse。因此，调用 PrepareForWriting 本身不会在列表中引入锁。即使克隆复制也是在调用 EndUse后作为辅助操作完成的。