BitArray.SyncRoot Propriété
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.
Obtient un objet qui peut être utilisé pour synchroniser l’accès à BitArray.
public:
property System::Object ^ SyncRoot { System::Object ^ get(); };
public object SyncRoot { get; }
member this.SyncRoot : obj
Public ReadOnly Property SyncRoot As Object
Valeur de propriété
Objet qui peut être utilisé pour synchroniser l'accès à BitArray.
Implémente
Exemples
L’exemple de code suivant montre comment verrouiller la collection à l’aide de pendant SyncRoot toute l’énumération.
BitArray^ myCollection = gcnew BitArray(64, true);
bool lockTaken = false;
try
{
Monitor::Enter(myCollection->SyncRoot, lockTaken);
for each (Object^ item in myCollection)
{
// Insert your code here.
}
}
finally
{
if (lockTaken)
{
Monitor::Exit(myCollection->SyncRoot);
}
}
BitArray myCollection = new BitArray(64, true);
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As New BitArray(64, true)
SyncLock myCollection.SyncRoot
For Each item In myCollection
' Insert your code here.
Next item
End SyncLock
La récupération de la valeur de cette propriété est une O(1)
opération.
Remarques
Les classes dérivées peuvent fournir leur propre version synchronisée du à l’aide BitArray de la SyncRoot propriété . Le code de synchronisation doit effectuer des opérations sur le SyncRootBitArraydu , pas directement sur le BitArray. Cela garantit un bon fonctionnement des collections dérivées d’autres objets. Plus précisément, il maintient une synchronisation correcte avec d’autres threads qui peuvent modifier simultanément l’objet BitArray .
L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads au cours de l’énumération, vous pouvez verrouiller la collection pendant l’ensemble de l’énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.