WeakEventManager.ListenerList.PrepareForWriting Метод

Определение

Пространство имен:

System.Windows

Сборка:

WindowsBase.dll

Проверяет, используется ли в данный момент указанный список. и если это так, устанавливает ссылочный параметр списка на его копию вместо оригинала.

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

Параметры

list

WeakEventManager.ListenerList

Список для проверки состояния использования и потенциального копирования.

Возвращаемое значение

Boolean

Значение true, если указанный список использовался во время вызова и поэтому ссылка на параметр list была сброшена к копии. Значение false, если указанный список не использовался, что означает оставление ссылки на параметр list без изменений.

Комментарии

Если данный список используется (это означает, что событие в настоящее время доставляется), вызов этого метода заменит входные данные list клоном. Существующие пользователи завершат доставку события в исходный список без вмешательства изменений в новый список.

Если метод возвращает true, вызывающим абонентам может потребоваться вставить новый список в собственные структуры данных, так как это указывает на вероятность того, что предоставленный список больше не является текущим.

Этот метод вызывает BeginUse внутренние вызовы, а затем немедленно вызывает EndUse. Поэтому вызов PrepareForWriting не приводит к блокировке списка. Даже копирование клона выполняется как вспомогательная операция после вызова EndUse.

См. также раздел

• BeginUse()
• EndUse()