WeakEventManager.ListenerList Класс

Ссылка

Определение

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

Сборка:: WindowsBase.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет встроенный список-коллекцию для хранения прослушивателей WeakEventManager.

protected: ref class WeakEventManager::ListenerList

protected class WeakEventManager.ListenerList

Protected Class WeakEventManager.ListenerList

Наследование: Object
WeakEventManager.ListenerList

Производный: System.Windows.WeakEventManager.ListenerList<TEventArgs>

Хотя этот список содержит элементы, похожие на IList те, которые определены и ICollectionпредоставляют аналогичные функциональные возможности, этот класс не реализует ни одно из этих интерфейсов.

Большинству WeakEventManager производных классов не нужно использовать члены WeakEventManager.ListenerList. Методы WeakEventManager и ProtectedRemoveListener внутренние методы ProtectedAddListener используют по умолчанию WeakEventManager.ListenerList по одному списку для каждогоsource.

Методы необходимо вызывать WeakEventManager.ListenerList только в том случае, если WeakEventManager класс поддерживает несколько списков для одного сочетания источников событий, каждый из которых создается для учета различных условий события. В этом случае вы не будете использовать ProtectedAddListener и ProtectedRemoveListener вместо этого реализуете AddListener или RemoveListener будете работать с прослушивателями только в одном из внутренних списков прослушивателей, как правило, на основе добавляемого параметра AddListener или RemoveListener. Кроме того, реализация обработчика, получающая необработанное событие, не может просто вызываться DeliverEvent; вместо этого необходимо отслеживать особенности события и доставлять событие только в соответствующий список с помощью DeliverEventToList.

Предоставляются различные методы WeakEventManager.ListenerList , позволяющие работать с внутренними списками и предотвращать изменение списка во время фактической доставки события.

Примером класса, который использовал этот метод реализации, является PropertyChangedEventManagerсохранение отдельных списков прослушивателя для PropertyChanged зависимости от того, какое свойство изменилось.

Использование текста XAML

Этот класс нельзя использовать в XAML.

Конструкторы

WeakEventManager.ListenerList()	Инициализирует новый экземпляр класса WeakEventManager.ListenerList.
WeakEventManager.ListenerList(Int32)	Выполняет инициализацию нового экземпляра класса WeakEventManager.ListenerList с указанными начальными возможностями.

Свойства

Count	Возвращает число элементов, содержащихся в списке WeakEventManager.ListenerList.
Empty	Возвращает значение, представляющее пустой список с целью сравнения.
IsEmpty	Получает значение, объявляющее, является ли данный объект WeakEventManager.ListenerList пустым.
Item[Int32]	Получает или задает конкретный элемент-прослушиватель из списка WeakEventManager.ListenerList.

Методы

Add(IWeakEventListener)	Добавляет объект IWeakEventListener в коллекцию WeakEventManager.ListenerList.
AddHandler(Delegate)	Добавляет обработчик событий в WeakEventManager.ListenerList.
BeginUse()	Объявляет список как используемый. Это предотвращает прямые изменения списка во время выполнения итерации по его элементам.
Clone()	Создает изменяемый клон этого WeakEventManager.ListenerList.
CopyTo(WeakEventManager+ListenerList)	Копирует текущий объект WeakEventManager.ListenerList в указанный WeakEventManager.ListenerList.
DeliverEvent(Object, EventArgs, Type)	Доставляет управляемое событие к каждому прослушивателю в WeakEventManager.ListenerList.
EndUse()	Снимает состояние блокировки, инициированное методом BeginUse().
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
PrepareForWriting(WeakEventManager+ListenerList)	Проверяет, используется ли в данный момент указанный список. и если это так, устанавливает ссылочный параметр списка на его копию вместо оригинала.
Purge()	Удаляет все записи из списка, в которых базовая цель ссылки представляет собой указатель null.
Remove(IWeakEventListener)	Удаляет первое вхождение элемента-прослушивателя из списка WeakEventManager.ListenerList.
RemoveHandler(Delegate)	Удаляет обработчик событий из WeakEventManager.ListenerList.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к

Поделиться через