VariableDispenser.LockOneForRead(String, Variables) Metodo

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Inserisce la variabile in un elenco, quindi la blocca per l'accesso in sola lettura.

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)

Parametri

variable

String

Variabile che si desidera bloccare per l'accesso in sola lettura.

variables

Variables

Nome della raccolta di variabili nella quale inserire la variabile richiesta.

Commenti

Questo metodo combina il lavoro del LockForRead metodo e il GetVariables metodo in una sola chiamata, perché si applica solo a una singola variabile.

Se la chiamata ha esito positivo, la variabile richiesta viene restituita come raccolta di una voce nella raccolta di variabili specificata dal parametro variablese la variabile è bloccata per l'accesso in sola lettura. Per sbloccare la variabile, rilasciare la raccolta di variabili usando il Unlock metodo della Variables classe . Se la chiamata al LockOneForRead metodo ha esito negativo, la variabile non è bloccata.

Le chiamate a questo metodo non influiscono sull'elenco di blocchi generato tramite chiamate a LockForRead.

Nota

È consigliabile non effettuare più chiamate a questo metodo quando si acquisiscono blocchi per le variabili da usare insieme perché ciò potrebbe causare deadlock. Tutte le variabili usate insieme devono essere richieste e bloccate insieme usando i metodi LockForRead o LockForWrite, seguiti da una chiamata a GetVariables.

Se un blocco ha avuto esito positivo, è possibile cancellarlo chiamando Unlock.