WeakEventManager.ListenerList Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona una lista de colecciones integrada para almacenar los agentes de escucha de WeakEventManager.
protected: ref class WeakEventManager::ListenerListprotected class WeakEventManager.ListenerListProtected Class WeakEventManager.ListenerList- Herencia
-
WeakEventManager.ListenerList
- Derivado
Comentarios
Aunque esta lista contiene miembros similares a los definidos por IList y ICollection, y proporcionan una funcionalidad similar, esta clase implementa ninguna de esas interfaces.
La mayoría WeakEventManager de las clases derivadas no necesitan usar ningún miembro en WeakEventManager.ListenerList. Los WeakEventManager métodos ProtectedAddListener y ProtectedRemoveListener usan un valor predeterminado WeakEventManager.ListenerList internamente, una lista para cada source.
Solo tiene que llamar WeakEventManager.ListenerList a métodos si la WeakEventManager clase mantiene varias listas para la misma combinación de origen de eventos, con cada lista creada para tener en cuenta diferentes condiciones del evento. En este caso, no usaría ProtectedAddListener y ProtectedRemoveListener , en su lugar, implementaría AddListener o RemoveListener actuaría sobre los agentes de escucha en una de las listas de escucha internas, normalmente en función de un parámetro que agregue a AddListener o RemoveListener. Además, la implementación del controlador que recibe el evento sin procesar no puede simplemente llamar a DeliverEvent; en su lugar, debe realizar un seguimiento de los detalles del evento y entregar el evento solo a la lista adecuada mediante DeliverEventToList.
Se proporcionan los distintos métodos de WeakEventManager.ListenerList para que pueda trabajar con las listas internas y para evitar la modificación de la lista durante la entrega real del evento.
Una clase de ejemplo que usó esta técnica de implementación es PropertyChangedEventManager, que mantiene listas de agentes de escucha independientes para PropertyChanged en función de la propiedad que ha cambiado.
Uso de texto XAML
No se puede usar esta clase en XAML.
Constructores
| WeakEventManager.ListenerList() |
Inicializa una nueva instancia de la clase WeakEventManager.ListenerList. |
| WeakEventManager.ListenerList(Int32) |
Inicializa una nueva instancia de la clase WeakEventManager.ListenerList con la capacidad inicial especificada. |
Propiedades
| Count |
Obtiene el número de elementos contenidos en WeakEventManager.ListenerList. |
| Empty |
Obtiene un valor que representa una lista vacía para fines de comparación. |
| IsEmpty |
Obtiene un valor que declara si este objeto WeakEventManager.ListenerList está vacío. |
| Item[Int32] |
Obtiene o establece un elemento de agente de escucha concreto en WeakEventManager.ListenerList. |
Métodos
| Add(IWeakEventListener) |
Agrega un objeto IWeakEventListener a la clase WeakEventManager.ListenerList. |
| AddHandler(Delegate) |
Agrega un controlador de eventos al WeakEventManager.ListenerList. |
| BeginUse() |
Declara la lista para que esté en uso. Esto evita los cambios directos a la lista durante las iteraciones de los elementos de lista. |
| Clone() |
Crea un clon modificable de esta WeakEventManager.ListenerList. |
| CopyTo(WeakEventManager+ListenerList) |
Copia el objeto actual WeakEventManager.ListenerList en el especificado WeakEventManager.ListenerList. |
| DeliverEvent(Object, EventArgs, Type) |
Entrega el evento que se administra a cada agente de escucha en el WeakEventManager.ListenerList. |
| EndUse() |
Desbloquea el estado bloqueado iniciado por BeginUse(). |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| PrepareForWriting(WeakEventManager+ListenerList) |
Comprueba si la lista proporcionada está en uso y, en tal caso, establece el parámetro de referencia de la lista en una copia de esa lista, no en el original. |
| Purge() |
Quita todas las entradas de la lista en las que el destino de la referencia subyacente es una referencia nula. |
| Remove(IWeakEventListener) |
Quita la primera aparición de un elemento de agente de escucha de WeakEventManager.ListenerList. |
| RemoveHandler(Delegate) |
Quita un controlador de eventos de WeakEventManager.ListenerList. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |