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 之後做為次要作業來完成。