VariableDispenser.LockOneForRead(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 schreibgeschützten Zugriff.

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)

Parameter

variable

String

Die Variable, die Sie für den schreibgeschützten Zugriff sperren möchten.

variables

Variables

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

Hinweise

Diese Methode kombiniert die Arbeit der LockForRead Methode und die GetVariables Methode in einem Aufruf, da sie nur auf eine einzelne Variable angewendet wird.

Wenn der Aufruf erfolgreich verläuft, wird die angeforderte Variable als one-entry-Auflistung in der variablen Auflistung zurückgegeben, die vom Parameter variablesangegeben wird, und die Variable ist für schreibgeschützten Zugriff gesperrt. Um die Variable zu entsperren, freigeben Sie die Variablensammlung mithilfe Unlock der Methode der Variables Klasse. Wenn der Aufruf der LockOneForRead Methode fehlschlägt, wird die Variable nicht gesperrt.

Aufrufe dieser Methode wirken sich nicht auf die über Aufrufe LockForReadgenerierte Sperrliste aus.

Hinweis

Es wird empfohlen, dass Sie nicht mehrere Aufrufe an diese Methode vornehmen, wenn Sie Sperrungen für Variablen abrufen, die zusammen verwendet werden sollen, da dies zu Deadlocks führen könnte. Alle Variablen, die zusammen verwendet werden, sollten mithilfe der Methoden LockForRead oder , LockForWritegefolgt von einem Aufruf, GetVariablesangefordert und zusammen gesperrt werden.

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