WeakEventManager.ListenerList Класс

Определение

Предоставляет встроенный список-коллекцию для хранения прослушивателей WeakEventManager.Provides a built-in collection list for storing listeners for a WeakEventManager.

protected: ref class WeakEventManager::ListenerList
protected class WeakEventManager.ListenerList
Protected Class WeakEventManager.ListenerList
Наследование
WeakEventManager.ListenerList
Производный

Комментарии

Несмотря на то, что этот список содержит элементы, похожие на те, которые определены IList и ICollection , и предоставляют аналогичные функциональные возможности, этот класс реализует ни один из этих интерфейсов.Although this list contains members that resemble those defined by IList and ICollection, and provide similar functionality, this class implements neither of those interfaces.

Большинству WeakEventManager производных классов не требуется использовать члены в WeakEventManager.ListenerList .Most WeakEventManager derived classes do not need to use any members on WeakEventManager.ListenerList. WeakEventManagerМетоды ProtectedAddListener и ProtectedRemoveListener используют внутреннее по умолчанию, по WeakEventManager.ListenerList одному списку для каждого из них source .The WeakEventManager methods ProtectedAddListener and ProtectedRemoveListener use a default WeakEventManager.ListenerList internally, one list for each source.

Методы вызываются только в том WeakEventManager.ListenerList случае WeakEventManager , если класс поддерживает несколько списков для одной комбинации источника события, при этом каждый список создается для учета различных условий события.You only need to call WeakEventManager.ListenerList methods if your WeakEventManager class maintains multiple lists for the same event-source combination, with each list created to account for different conditions of the event. В этом случае вы не используете и, ProtectedAddListener а ProtectedRemoveListener вместо этого реализуйте AddListener или RemoveListener для работы с прослушивателями только в одном из списков внутренних прослушивателей, обычно на основе параметра, добавляемого в AddListener или RemoveListener .In this case, you would not use ProtectedAddListener and ProtectedRemoveListener and would instead implement AddListener or RemoveListener to act upon listeners in just one of the internal listener lists, typically based on a parameter that you add to AddListener or RemoveListener. Кроме того, реализация обработчика, получающая необработанное событие, не может просто вызвать DeliverEvent . вместо этого необходимо отследить особенности события и доставить событие только в соответствующий список с помощью DeliverEventToList .Also, the handler implementation that receives the raw event cannot simply call DeliverEvent; you must instead keep track of the specifics of the event and deliver the event only to the appropriate list using DeliverEventToList.

Предоставляются различные методы, позволяющие WeakEventManager.ListenerList работать с внутренними списками, что позволяет предотвратить изменение списка во время фактической доставки события.The various methods of WeakEventManager.ListenerList are provided so that you can work with your internal lists and so that you can prevent modification of the list during actual delivery of the event.

Примером класса, который использовал этот метод реализации, является класс PropertyChangedEventManager , который поддерживает отдельные списки прослушивателей в зависимости от того, PropertyChanged какое свойство изменилось.An example class that used this implementation technique is PropertyChangedEventManager, which maintains separate listener lists for PropertyChanged based on which property changed.

Использование текста XAMLXAML Text Usage

Этот класс нельзя использовать в XAMLXAML .You cannot use this class in XAMLXAML.

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

WeakEventManager.ListenerList()

Инициализирует новый экземпляр класса WeakEventManager.ListenerList.Initializes a new instance of the WeakEventManager.ListenerList class.

WeakEventManager.ListenerList(Int32)

Выполняет инициализацию нового экземпляра класса WeakEventManager.ListenerList с указанными начальными возможностями.Initializes a new instance of the WeakEventManager.ListenerList class with the specified initial capacity.

Свойства

Count

Возвращает число элементов, содержащихся в списке WeakEventManager.ListenerList.Gets the number of items contained in the WeakEventManager.ListenerList.

Empty

Возвращает значение, представляющее пустой список с целью сравнения.Gets a value that represents an empty list for purposes of comparisons.

IsEmpty

Получает значение, объявляющее, является ли данный объект WeakEventManager.ListenerList пустым.Gets a value that declares whether this WeakEventManager.ListenerList is empty.

Item[Int32]

Получает или задает конкретный элемент-прослушиватель из списка WeakEventManager.ListenerList.Gets or sets a specific listener item in the WeakEventManager.ListenerList .

Методы

Add(IWeakEventListener)

Добавляет объект IWeakEventListener в коллекцию WeakEventManager.ListenerList.Adds a IWeakEventListener object to the WeakEventManager.ListenerList.

AddHandler(Delegate)

Добавляет обработчик событий в WeakEventManager.ListenerList.Adds an event handler to the WeakEventManager.ListenerList.

BeginUse()

Объявляет список как используемый.Declares the list to be in use. Это предотвращает прямые изменения списка во время выполнения итерации по его элементам.This prevents direct changes to the list during iterations of the list items.

Clone()

Создает изменяемый клон этого WeakEventManager.ListenerList.Creates a modifiable clone of this WeakEventManager.ListenerList.

CopyTo(WeakEventManager+ListenerList)

Копирует текущий WeakEventManager.ListenerList в указанный WeakEventManager.ListenerListCopies the current WeakEventManager.ListenerList to the specified WeakEventManager.ListenerList

DeliverEvent(Object, EventArgs, Type)

Доставляет управляемое событие к каждому прослушивателю в WeakEventManager.ListenerList.Delivers the event being managed to each listener in the WeakEventManager.ListenerList.

EndUse()

Снимает состояние блокировки, инициированное методом BeginUse().Unlocks the locked state initiated by BeginUse().

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
PrepareForWriting(WeakEventManager+ListenerList)

Проверяет, используется ли в данный момент указанный список. и если это так, устанавливает ссылочный параметр списка на его копию вместо оригинала.Checks to see whether the provided list is in use, and if so, sets the list reference parameter to a copy of that list rather than the original.

Purge()

Удаляет все записи из списка, в которых базовая цель ссылки представляет собой указатель null.Removes all entries from the list where the underlying reference target is a null reference.

Remove(IWeakEventListener)

Удаляет первое вхождение элемента-прослушивателя из списка WeakEventManager.ListenerList.Removes the first occurrence of a listener item from the WeakEventManager.ListenerList.

RemoveHandler(Delegate)

Удаляет обработчик событий из WeakEventManager.ListenerList.Removes an event handler from the WeakEventManager.ListenerList.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

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