WeakEventManager.ListenerList.PrepareForWriting Método
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í.
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.
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
Parámetros
Lista en la que se comprueba el estado de uso y, posiblemente, la copia.
Devoluciones
true
si la lista proporcionada estaba en uso en el momento de la llamada y, por consiguiente, la referencia del parámetro list
se restableció como una copia. false
si la lista proporcionada no estaba en uso, en cuyo caso la referencia del parámetro list
se mantiene sin cambios.
Comentarios
Si la lista especificada está en uso (lo que significa que se está entregando un evento), al llamar a este método se reemplazará la entrada list
por un clon. Los usuarios existentes terminarán de entregar el evento a la lista original, sin interferencias de los cambios en la nueva lista.
Si el método devuelve true
, es posible que los llamadores quieran insertar la nueva lista en sus propias estructuras de datos, ya que esto indica la posibilidad de que la lista proporcionada ya no esté actualizada.
Este método llama BeginUse internamente y, a continuación, llama inmediatamente a EndUse. Por lo tanto, la llamada PrepareForWriting a no introduce un bloqueo en la lista. Incluso la copia de clonación se realiza como una operación secundaria después de llamar a EndUse.