VariableDispenser Classe
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.
Accede alla raccolta Variables durante l'esecuzione del pacchetto. Questa classe non può essere ereditata.
public ref class VariableDispenser sealed : Microsoft::SqlServer::Dts::Runtime::DtsObjectpublic sealed class VariableDispenser : Microsoft.SqlServer.Dts.Runtime.DtsObjecttype VariableDispenser = class
inherit DtsObjectPublic NotInheritable Class VariableDispenser
Inherits DtsObject- Ereditarietà
Commenti
Esistono due scenari per l'uso del dispenser di variabili.
Si vuole solo una variabile. In questo scenario, chiamare LockOneForRead o LockOneForWrite e una raccolta con un elemento viene restituito.
Si desiderano diverse variabili. In questo scenario, chiamare LockForRead e LockForWrite più volte, una per ogni variabile. Verranno compilati due elenchi, un elenco contenente le variabili per la lettura e un elenco contenente variabili per la scrittura. Successivamente, chiamare GetVariables , che fornisce una raccolta che contiene tutte le variabili bloccate. Se ha GetVariables esito positivo, i due elenchi, ovvero gli elenchi di nomi di variabili, non i blocchi effettivi, vengono cancellati.
Per rilasciare in modo esplicito i blocchi, chiamare Unlock sulla raccolta. Questo metodo sblocca le variabili stesse. Se GetVariables ha esito negativo, gli elenchi rimangono invariati ed è possibile chiamare di GetVariables nuovo. Se ancora non si riesce a ottenere le variabili, chiamare Reset per cancellare gli elenchi e riportare il dispenser della variabile allo stato iniziale.
La Variables raccolta contiene una Locked proprietà che indica se una raccolta di variabili di dispenser delle variabili è bloccata ( true ) o sbloccata ( false ). Il motivo per cui si esamina questa proprietà è che alcune attività rilasciano in modo esplicito i blocchi alle variabili utilizzate e la chiamata di Unlock due volte genera un errore. Pertanto, è necessario utilizzare questa proprietà per determinare se la raccolta distribuita è bloccata prima della chiamata a Unlock .
Importante
VariableDispenserViene utilizzato con le classi di Runtime. Se si usano i componenti del flusso di dati ( Microsoft.SqlServer.Dts.Pipeline ), potrebbe essere necessario usare IDTSVariableDispenser100 invece. Per conoscere il dispenser di variabili da usare, vedere la documentazione relativa all'oggetto in cui si stanno acquisendo le variabili e verificare l'oggetto restituito del metodo.
Metodi
| Contains(String) |
Specifica se un elemento può essere recuperato dalla raccolta VariableDispenser tramite l'indicizzazione senza generare un'eccezione. |
| Equals(Object) |
Determina se due istanze di un oggetto sono uguali. (Ereditato da DtsObject) |
| GetHashCode() |
Restituisce il codice hash per l'istanza. (Ereditato da DtsObject) |
| GetQualifiedName(String) |
Restituisce il nome completo della variabile. |
| GetVariables(Variables) |
Blocca le variabili presenti nell'elenco in sola lettura e nell'elenco in lettura/scrittura. |
| LockForRead(String) |
Aggiunge la variabile all'elenco di variabili da bloccare per l'accesso in sola lettura. |
| LockForWrite(String) |
Aggiunge la variabile all'elenco di variabili da bloccare per l'accesso in lettura/scrittura. |
| LockOneForRead(String, Variables) |
Inserisce la variabile in un elenco, quindi la blocca per l'accesso in sola lettura. |
| LockOneForWrite(String, Variables) |
Inserisce la variabile in un elenco, quindi la blocca per l'accesso in lettura/scrittura. |
| Reset() |
Cancella sia l'elenco in sola lettura che l'elenco in lettura/scrittura quando non è possibile chiamare GetVariables(Variables). |