DataConnection.GetExclusiveAccessProxy, méthode
Extrait une instance de proxy qui permet à l'appelant l'accès exclusif à la connexion de données.
Espace de noms : Microsoft.VisualStudio.Data
Assembly : Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.dll)
Syntaxe
'Déclaration
Public MustOverride Function GetExclusiveAccessProxy ( _
lockTimeout As Integer _
) As DataConnection
public abstract DataConnection GetExclusiveAccessProxy(
int lockTimeout
)
public:
virtual DataConnection^ GetExclusiveAccessProxy(
int lockTimeout
) abstract
abstract GetExclusiveAccessProxy :
lockTimeout:int -> DataConnection
public abstract function GetExclusiveAccessProxy(
lockTimeout : int
) : DataConnection
Paramètres
lockTimeout
Type : Int32La durée, en secondes, à l'attente sur verrouiller la connexion avant de retourner.
Valeur de retour
Type : Microsoft.VisualStudio.Data.DataConnection
Retourne une instance de l'objet d' DataConnection de proxy qui permet à l'appelant l'accès exclusif à la connexion, ou retourne nullune référence null (Nothing en Visual Basic) si l'expiration du verrouillage a été atteinte et la connexion ne peut pas être verrouillée.
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | Cet objet est un proxy exclusif d'accès qui ne dispose plus d'un accès exclusif. |
Notes
Normalement, verrouiller de la connexion se produit sur une base par thread, garantissant que les threads ne peuvent pas interagir avec la connexion de données. Toutefois, dans certains cas ce n'est pas un mécanisme approprié de verrouillage pour le client, comme lorsqu'un client souhaite exécuter une opération verrouillée à l'aide d'une connexion unique qui couvre plusieurs threads. Dans ce cas, un client peut appeler cette méthode pour récupérer une instance non verrouillante de la connexion sur lequel ils peuvent ensuite exécuter leur propre accès sérialisé.
L'objet retourné par cette méthode est une nouvelle instance de la classe d' DataConnection qui a un attribut spécial permettant ainsi qu'à des appels via cette instance pour réussir. Les appels via toutes les autres références à l'objet d' DataConnection d'origine sont ensuite bloqués jusqu'à ce que la méthode d' ReleaseExclusiveAccessProxy est appelée sur le proxy exclusif d'accès.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.