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. La 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 distributore di variabili.
Si vuole una sola variabile. In questo scenario, chiamare LockOneForRead o LockOneForWritee un insieme con un elemento viene restituito.
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). |