VariableDispenser.LockOneForRead(String, Variables) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 un'unica 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 variables e 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
Si consiglia di non effettuare più chiamate a questo metodo durante l'acquisizione di blocchi per le variabili da usare insieme, perché questo potrebbe causare deadlock. Tutte le variabili usate insieme devono essere richieste e bloccate insieme usando i metodi LockForRead o LockForWrite , seguite da una chiamata a GetVariables .
Se un blocco ha avuto esito positivo, è possibile cancellarlo chiamando Unlock .