Share via


VariableDispenser.LockOneForWrite(String, Variables) Méthode

Définition

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

public:
 void LockOneForWrite(System::String ^ variable, Microsoft::SqlServer::Dts::Runtime::Variables ^ % variables);
public void LockOneForWrite (string variable, ref Microsoft.SqlServer.Dts.Runtime.Variables variables);
member this.LockOneForWrite : string * Variables -> unit
Public Sub LockOneForWrite (variable As String, ByRef variables As Variables)

Paramètres

variable
String

Nom de la variable à verrouiller pour l'accès en lecture/écriture.

variables
Variables

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

Remarques

Cette méthode combine le travail de la LockForWrite 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 l’accès en lecture/écriture. Pour déverrouiller la variable, relâchez la collection de variables à l’aide de la Unlock méthode de la classe Variables. Si l’appel de LockOneForWrite 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 par les appels à LockForWrite.

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 en appelant les méthodes LockForRead ou LockForWrite, suivie d’un appel à la GetVariables méthode.

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

S’applique à