Variables Classe

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Contém uma coleção de objetos Variables que são acessados por meio de vários objetos. Essa classe não pode ser herdada.

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

Herança

Object

DTSReadOnlyCollectionBase

Variables

Comentários

O SSIS (Integration Services) fornece variáveis de sistema e dá suporte a variáveis de usuário personalizadas. Quando você cria um novo pacote, adiciona um contêiner ou uma tarefa ao pacote ou cria um manipulador de eventos, o SSIS inclui automaticamente um conjunto de variáveis do sistema para o item. As variáveis do sistema estão sempre localizadas no System namespace. System as variáveis contêm informações úteis sobre o pacote e seus contêineres, tarefas e manipuladores de eventos. System as variáveis contêm informações como o nome do computador no qual o pacote é executado e a hora em que o pacote é iniciado. Você pode exibir as informações contidas em uma variável do sistema, mas não pode adicionar ou atualizar variáveis do sistema.

Você também pode criar variáveis personalizadas para uso em pacotes, contêineres, tarefas, transformações e restrições de precedência. Variáveis personalizadas podem ser criadas no User namespace ou em um namespace de sua escolha. Variáveis personalizadas podem ser usadas nas expressões que o contêiner Loop For, a transformação Coluna Derivada, a transformação Divisão Condicional e restrições de precedência podem conter. Para obter mais informações, consulte Usar Variáveis em Pacotes.

Cada contêiner no modelo de objeto SSIS tem uma Variables coleção. Essa coleção é acessível para cada filho do contêiner. Uma variável é acessada da coleção usando seu nome ou seu índice. A Variables coleção em um contêiner representa uma agregação das variáveis na coleção de seu pai. A Variables coleção da Package classe é visível para todos os objetos no pacote, fornecendo uma coleção globalmente visível. Por outro lado, as variáveis contidas em uma tarefa são limitadas em escopo e visibilidade e só são visíveis pela tarefa.

Importante

O Variables é usado com as classes runtime. Se você estiver usando componentes de fluxo de dados (Microsoft.SqlServer.Dts.Pipeline), talvez seja necessário usar o IDTSVariables100. Para saber em qual coleção de variáveis usar, consulte a documentação do objeto no qual você está adquirindo variáveis e verifique o valor retornado.

Campos

m_unmanagedColl

A coleção não gerenciada. (Herdado de DTSReadOnlyCollectionBase)

Propriedades

Count	Obtém o número de elementos contidos na instância de DTSReadOnlyCollectionBase. (Herdado de DTSReadOnlyCollectionBase)
IsSynchronized	Obtém um valor que indica se o acesso a DTSReadOnlyCollectionBase é sincronizado (thread-safe). (Herdado de DTSReadOnlyCollectionBase)
Item[Object]	Retorna um objeto Variable da coleção Variables.
Locked	Um booliano que indica se as variáveis na Variables coleção estão bloqueadas.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao DTSReadOnlyCollectionBase. (Herdado de DTSReadOnlyCollectionBase)

Métodos

Add(String, Boolean, String, Object)	Adiciona um objeto Variable à coleção Variables.
Contains(Object)	Retorna um Boolean que indica se os itens na coleção podem ser acessados usando indexação sem gerar uma exceção.
CopyTo(Array, Int32)	Copia todo o DTSReadOnlyCollectionBase para uma matriz unidimensional compatível, iniciando no índice especificado da matriz de destino. (Herdado de DTSReadOnlyCollectionBase)
CreateManagedObject(Object)	Cria um objeto gerenciado com base em um objeto não gerenciado. (Herdado de DTSReadOnlyCollectionBase)
GetCount()	Recupera o número de objetos na coleção. (Herdado de DTSReadOnlyCollectionBase)
GetEnumerator()	Retorna um enumerador VariableEnumerator para uso na iteração pela coleção Variables.
GetManagedEnumerator(Object)	Obtém o enumerador gerenciado de um enumerador não gerenciado. (Herdado de DTSReadOnlyCollectionBase)
Join(Variable)	Une o Variable à coleção Variables.
Remove(Object)	Remove um objeto Variable da coleção Variables.
Unlock()	Libera os bloqueios na coleção de variáveis e sinaliza o estado da coleção de variáveis como inválido ou desconhecido.