WeakEventManager.ListenerList.PrepareForWriting Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Vérifie que la liste fournie est en cours d'utilisation et, le cas échéant, affecte au paramètre de référence de la liste une copie de cette liste plutôt que son 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
Paramètres
Liste dont l'état d'utilisation est à vérifier et la copie éventuellement.
Retours
true
si la liste fournie est utilisée au moment de l'appel et donc que la référence au paramètre de list
a été réinitialisée de façon à devenir une copie. false
si la liste fournie n'est pas en cours d'utilisation, auquel cas que la référence au paramètre list
reste inchangée.
Remarques
Si la liste donnée est utilisée (ce qui signifie qu’un événement est actuellement remis), l’appel de cette méthode remplace l’entrée list
par un clone. Les utilisateurs existants terminent la remise de l’événement à la liste d’origine, sans interférence entre les modifications apportées à la nouvelle liste.
Si la méthode retourne true
, les appelants peuvent souhaiter insérer la nouvelle liste dans leurs propres structures de données, car cela indique la possibilité que la liste fournie ne soit plus actuelle.
Cette méthode appelle BeginUse en interne, puis appelle EndUseimmédiatement . Par conséquent, l’appel PrepareForWriting n’introduit pas lui-même un verrou sur la liste. Même la copie de clone est effectuée en tant qu’opération secondaire après l’appel EndUse.