SqlParameterCollection.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 SqlParameterCollectionau .
public:
virtual property System::Object ^ SyncRoot { System::Object ^ get(); };public override object SyncRoot { get; }member this.SyncRoot : objPublic Overrides ReadOnly Property SyncRoot As ObjectValeur de propriété
Objet qui peut être utilisé pour synchroniser l’accès au SqlParameterCollection.
Exemples
L’exemple de code suivant montre comment verrouiller la collection à l’aide de la SyncRoot propriété pendant toute l’énumération.
ICollection^ myCollection = someCollection;
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);
}
}
ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
foreach (object item in myCollection)
{
// Insert your code here.
}
}
Dim myCollection As ICollection = someCollection
SyncLock myCollection.SyncRoot
For Each item In myCollection
' Insert your code here.
Next item
End SyncLock
Remarques
Ce membre est une implémentation explicite de membre d’interface. Elle ne peut être utilisée que lorsque l’instance SqlParameterCollection est convertie en ICollection interface.
Pour les collections dont le magasin sous-jacent n’est pas disponible publiquement, l’implémentation attendue doit retourner l’instance actuelle. Notez que le pointeur vers l’instance actuelle peut ne pas suffire pour les collections qui encapsulent d’autres collections ; celles-ci doivent retourner la propriété de SyncRoot la collection sous-jacente.
La plupart des classes de collection de l’espace System.Collections de noms implémentent également une Synchronized méthode, qui fournit un wrapper synchronisé autour de la collection sous-jacente. Toutefois, les classes dérivées peuvent fournir leur propre version synchronisée de la collection à l’aide de la SyncRoot propriété. Le code de synchronisation doit effectuer des opérations sur la SyncRoot propriété de la collection, et non directement sur la collection. Cela garantit le bon fonctionnement des collections dérivées d’autres objets. Plus précisément, il gère une synchronisation appropriée avec d’autres threads susceptibles de modifier simultanément l’instance de collection.
En l’absence d’une Synchronized méthode sur une collection, l’utilisation attendue est SyncRoot la suivante :
ICollection^ myCollection = someCollection;
bool lockTaken = false;
try
{
Monitor::Enter(myCollection->SyncRoot, lockTaken);
// Some operation on the collection, which is now thread safe.
}
finally
{
if (lockTaken)
{
Monitor::Exit(myCollection->SyncRoot);
}
}
ICollection myCollection = someCollection;
lock(myCollection.SyncRoot)
{
// Some operation on the collection, which is now thread safe.
}
Dim myCollection As ICollection = someCollection
SyncLock myCollection.SyncRoot
' Some operation on the collection, which is now thread safe.
End SyncLock
L’énumération par le biais d’une collection n’est intrinsèquement pas une procédure thread-safe. Même lorsqu’une collection est synchronisée, d’autres threads peuvent toujours modifier la collection, ce qui provoque la levée d’une exception par l’énumérateur. Pour garantir la sécurité des threads pendant l’énumération, vous pouvez verrouiller la collection pendant toute l’énumération ou intercepter les exceptions résultant des modifications apportées par d’autres threads.
