Condividi tramite


VariableDispenser Classe

Definizione

Accede alla raccolta Variables durante l'esecuzione del pacchetto. La 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 distributore di variabili.

  1. Si vuole una sola variabile. In questo scenario, chiamare LockOneForRead o LockOneForWritee un insieme con un elemento viene restituito.

  2. Si desiderano diverse variabili. In questo scenario, chiamare LockForRead e LockForWrite più volte, uno per ogni variabile. In questo modo vengono compilati due elenchi, un elenco che contiene variabili per la lettura e un elenco che contiene variabili per la scrittura. Chiamare GetVariablesquindi , che offre una raccolta contenente tutte le variabili bloccate. In GetVariables caso di esito positivo, i due elenchi, ovvero gli elenchi di nomi delle variabili, non i blocchi effettivi, vengono cancellati.

Per rilasciare in modo esplicito i blocchi, chiamare Unlock la raccolta. Questo metodo sblocca le variabili stesse. Se GetVariables non riesce, gli elenchi rimangono invariati e è possibile chiamare GetVariables di nuovo. Se non si riesce ancora a ottenere le variabili, chiamare Reset per cancellare gli elenchi e ripristinare lo stato iniziale della variabile.

La Variables raccolta contiene una Locked proprietà che indica se una raccolta di variabili di variabili è bloccata () o sbloccata (falsetrue). Il motivo per esaminare questa proprietà è che alcune attività rilasciano in modo esplicito i blocchi alle variabili che usano e la chiamata Unlock due volte genera un errore. Pertanto, è consigliabile usare questa proprietà per determinare se la raccolta dispensata è bloccata prima di chiamare Unlock.

Importante

Viene VariableDispenser usato con le classi runtime. Se si usano componenti del flusso di dati (Microsoft.SqlServer.Dts.Pipeline), potrebbe essere necessario usare invece.IDTSVariableDispenser100 Per conoscere la variabile da usare, vedere la documentazione dell'oggetto su cui si acquisiscono 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