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 -> unitPublic 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.