VariableDispenser Classe

Definizione

Accede alla raccolta Variables durante l'esecuzione del pacchetto. Questa classe non può essere ereditata.

public ref class VariableDispenser sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject
public sealed class VariableDispenser : Microsoft.SqlServer.Dts.Runtime.DtsObject
type VariableDispenser = class
    inherit DtsObject
Public NotInheritable Class VariableDispenser
Inherits DtsObject
Ereditarietà
VariableDispenser

Commenti

Esistono due scenari per l'uso del dispenser di variabili.

  1. Si vuole solo una variabile. In questo scenario, chiamare LockOneForRead o LockOneForWrite e una raccolta con un elemento viene restituito.

  2. 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).

Si applica a