VariableDispenser.LockOneForRead(String, Variables) Méthode

Définition

Espace de noms:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Place la variable dans une liste, puis la verrouille pour l'accès en lecture seule.

public:
 void LockOneForRead(System::String ^ variable, Microsoft::SqlServer::Dts::Runtime::Variables ^ % variables);

public void LockOneForRead (string variable, ref Microsoft.SqlServer.Dts.Runtime.Variables variables);

member this.LockOneForRead : string * Variables -> unit

Public Sub LockOneForRead (variable As String, ByRef variables As Variables)

Paramètres

variable

String

Variable que vous souhaitez verrouiller pour l'accès en lecture seule.

variables

Variables

Nom de la collection de variables dans laquelle placer la variable demandée.

Remarques

Cette méthode combine le travail de la LockForRead méthode et la GetVariables méthode dans un seul appel, car elle s’applique à une seule variable.

Si l’appel réussit, la variable demandée est retournée en tant que collection à entrée unique dans la collection de variables spécifiée par le paramètre variables, et la variable est verrouillée pour un accès en lecture seule. Pour déverrouiller la variable, relâchez la collection de variables à l’aide de la Unlock méthode de la Variables classe. Si l’appel à la LockOneForRead méthode échoue, la variable n’est pas verrouillée.

Les appels à cette méthode n’affectent pas la liste de verrous générée via des appels à LockForRead.

Notes

Il est recommandé de ne pas effectuer plusieurs appels à cette méthode lors de l’acquisition de verrous pour que les variables soient utilisées ensemble, car cela peut entraîner des interblocages. Toutes les variables utilisées ensemble doivent être demandées et verrouillées ensemble à l’aide des méthodes LockForRead ou LockForWrite, suivies d’un appel à GetVariables.

Si un verrou a réussi, vous pouvez l’effacer en appelant Unlock.