VariableDispenser.LockOneForWrite(String, Variables) Methode

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Fügt die Variable in eine Liste ein und sperrt sie für den Lese-/Schreibzugriff.

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)

Parameter

variable

String

Der Name der Variablen, die für den Lese-/Schreibzugriff gesperrt werden soll.

variables

Variables

Der Name der Variablenauflistung, in die die angeforderte Variable aufgenommen werden soll.

Hinweise

Diese Methode kombiniert die Arbeit der LockForWrite Methode und die GetVariables Methode in einem Aufruf, da sie nur für eine einzelne Variable gilt.

Wenn der Aufruf erfolgreich verläuft, wird die angeforderte Variable in der durch den Parameter variablesangegebenen Variablenauflistung als ein Eintragsauflistung zurückgegeben, und die Variable ist für Lese-/Schreibzugriff gesperrt. Um die Variable zu entsperren, geben Sie die Variable-Auflistung mithilfe Unlock der Methode der Variables-Klasse frei. Wenn der LockOneForWrite Methodenaufruf fehlschlägt, ist die Variable nicht gesperrt.

Aufrufe dieser Methode wirken sich nicht auf die durch Aufrufe generierte LockForWriteSperrliste aus.

Hinweis

Es wird empfohlen, nicht mehrere Aufrufe an diese Methode zu tätigen, wenn Sie Sperren für Variablen erwerben, die zusammen verwendet werden sollen, da dies zu Deadlocks führen könnte. Alle variablen, die zusammen verwendet werden, sollten angefordert und gesperrt werden, indem sie die Methoden LockForRead aufrufen oder LockForWrite, gefolgt von einem Aufruf der GetVariables Methode.

Wenn eine Sperre erfolgreich war, können Sie sie durch Aufrufen Unlocklöschen.