Variables Classe

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Contiene una raccolta di oggetti Variables,accessibili tramite diversi oggetti. La classe non può essere ereditata.

public ref class Variables sealed : Microsoft::SqlServer::Dts::Runtime::DTSReadOnlyCollectionBase

public sealed class Variables : Microsoft.SqlServer.Dts.Runtime.DTSReadOnlyCollectionBase

type Variables = class
    inherit DTSReadOnlyCollectionBase

Public NotInheritable Class Variables
Inherits DTSReadOnlyCollectionBase

Ereditarietà

Object

DTSReadOnlyCollectionBase

Variables

Commenti

Integration Services (SSIS) fornisce variabili di sistema e supporta variabili utente personalizzate. Quando si crea un nuovo pacchetto, aggiungere un contenitore o un'attività al pacchetto o creare un gestore eventi, SSIS include automaticamente un set di variabili di sistema per l'elemento. Le variabili di sistema si trovano sempre nello System spazio dei nomi. System le variabili contengono informazioni utili sul pacchetto e sui relativi contenitori, attività e gestori eventi. System le variabili contengono informazioni, ad esempio il nome del computer in cui viene eseguito il pacchetto e l'ora di avvio del pacchetto. È possibile visualizzare le informazioni contenute in una variabile di sistema, ma non è possibile aggiungere o aggiornare le variabili di sistema.

È anche possibile creare variabili personalizzate da usare in pacchetti, contenitori, attività, trasformazioni e vincoli di precedenza. Le variabili personalizzate possono essere create nello spazio dei nomi o nello User spazio dei nomi desiderato. Le variabili personalizzate possono essere usate nelle espressioni che il contenitore Ciclo For, la trasformazione Colonna derivata, la trasformazione Divisione condizionale e i vincoli di precedenza possono contenere. Per altre informazioni, vedere Usare le variabili nei pacchetti.

Ogni contenitore nel modello a oggetti SSIS include una Variables raccolta. Questa raccolta è accessibile a ogni figlio del contenitore. Una variabile viene accessibile dalla raccolta usando il nome o il relativo indice. La Variables raccolta in un contenitore rappresenta un'aggregazione delle variabili nella raccolta del relativo elemento padre. La Variables raccolta della Package classe è visibile a tutti gli oggetti nel pacchetto, fornendo una raccolta visibile a livello globale. Al contrario, le variabili contenute in un'attività sono limitate nell'ambito e nella visibilità e sono visibili solo dall'attività.

Importante

Viene Variables usato con le classi runtime. Se si usano i componenti del flusso di dati (Microsoft.SqlServer.Dts.Pipeline), potrebbe essere necessario usare .IDTSVariables100 Per conoscere la raccolta di variabili da usare, vedere la documentazione dell'oggetto su cui si acquisiscono variabili e verificare il valore restituito.

Campi

m_unmanagedColl

Raccolta non gestita. (Ereditato da DTSReadOnlyCollectionBase)

Proprietà

Count	Ottiene il numero di elementi contenuti nell'istanza di DTSReadOnlyCollectionBase. (Ereditato da DTSReadOnlyCollectionBase)
IsSynchronized	Ottiene un valore che indica se l'accesso a DTSReadOnlyCollectionBase è sincronizzato (thread-safe). (Ereditato da DTSReadOnlyCollectionBase)
Item[Object]	Restituisce un oggetto Variable dalla raccolta Variables.
Locked	Valore booleano che indica se le variabili nella Variables raccolta sono bloccate.
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a DTSReadOnlyCollectionBase. (Ereditato da DTSReadOnlyCollectionBase)

Metodi

Add(String, Boolean, String, Object)	Aggiunge un oggetto Variable alla raccolta Variables.
Contains(Object)	Restituisce un valore booleano che indica se è possibile accedere agli elementi della raccolta usando l'indicizzazione senza generare un'eccezione.
CopyTo(Array, Int32)	Copia l'intero oggetto DTSReadOnlyCollectionBase in una matrice compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione. (Ereditato da DTSReadOnlyCollectionBase)
CreateManagedObject(Object)	Crea l'oggetto gestito da un oggetto non gestito. (Ereditato da DTSReadOnlyCollectionBase)
GetCount()	Recupera il numero di oggetti nella raccolta. (Ereditato da DTSReadOnlyCollectionBase)
GetEnumerator()	Restituisce un enumeratore VariableEnumerator da utilizzare nell'iterazione della raccolta Variables.
GetManagedEnumerator(Object)	Ottiene l'enumeratore gestito da un enumeratore non gestito. (Ereditato da DTSReadOnlyCollectionBase)
Join(Variable)	Crea il join tra l'oggetto Variable e la raccolta Variables.
Remove(Object)	Rimuove un oggetto Variable dalla raccolta Variables.
Unlock()	Rilascia i blocchi sulla raccolta di variabili e contrassegna lo stato della raccolta di variabili come non valido o sconosciuto.