Editor de Loop Foreach (página Coleção)
Use a página Coleção da caixa de diálogo Editor de Loop Foreach para especificar e configurar o tipo de enumerador.
Para saber mais sobre o contêiner Loop Foreach e como configurá-lo, consulte Contêiner Loop Foreach e Como configurar um contêiner Loop Foreach.
Opções estáticas
Enumerador
Selecione o tipo de enumerador na lista. As opções desta propriedade estão listadas na tabela a seguir.Valor
Descrição
Enumerador de Arquivo Foreach
Enumera arquivos. Se este valor for selecionado, serão exibidas as opções dinâmicas na seção Enumerador de Arquivo Foreach.
Enumerador de Item Foreach
Enumera valores em um item. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador de Item Foreach.
Enumerador ADO Foreach
Enumera tabelas ou linhas em tabelas. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador ADO Foreach.
Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach
Enumera um esquema. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador ADO.NET Foreach.
Enumerador Foreach de Variável
Enumera o valor em uma variável. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador Foreach de Variável.
Enumerador NodeList Foreach
Enumera nós em um documento XML. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador NodeList Foreach.
Enumerador SMO Foreach
Enumera um objeto SMO. Se este valor for selecionado serão exibidas as opções dinâmicas na seção Enumerador SMO Foreach.
Expressões
Clique ou expanda Expressões para exibir a lista de expressões de propriedade existentes. Clique no botão de reticências (...) para adicionar uma expressão de propriedade para uma propriedade de enumerador ou edite e avalie uma expressão de propriedade existente.Tópicos relacionados: Referência de Expressões do Integration Services, Editor de Expressões de Propriedades, Construtor de Expressões
Opções dinâmicas do Enumerador
Enumerador = Enumerador de Arquivo Foreach
Você usa o Enumerador de Arquivo Foreach para enumerar arquivos em uma pasta. Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL, você poderá usar o enumerador de arquivo Foreach para enumerar arquivos que contêm instruções SQL executadas pela tarefa Execute SQL. O enumerador pode ser configurado para incluir subpastas.
O conteúdo das pastas e subpastas que o enumerador de arquivo Foreach enumera pode alterar-se enquanto o loop estiver sendo executando porque processos externos ou tarefas no loop adicionam, renomeiam ou excluem arquivos enquanto o loop está em execução. Isso significa que podem acontecer várias situações inesperadas:
Se forem excluídos arquivos, uma tarefa no Loop Foreach poderá executar o trabalho em um conjunto de arquivos diferente dos arquivos usados por tarefas subseqüentes.
Se forem renomeados arquivos e um processo externo adicionar arquivos automaticamente para substituir os arquivos renomeados, o Loop Foreach poderá executar o trabalho duas vezes no mesmo conteúdo de arquivo.
Se forem adicionados arquivos, poderá ser difícil determinar para quais arquivos o Loop Foreach executou o trabalho.
Pasta
Forneça o caminho da pasta raiz a enumerar.Procurar
Procure para localizar a pasta raiz.Arquivos
Especifique os arquivos a enumerar.Quando você especifica uma extensão de nome de arquivo, o enumerador também retorna os arquivos que têm a mesma extensão com caracteres adicionais acrescentados. (É o mesmo comportamento do comando dir no sistema operacional, que também compara nomes de arquivos 8.3 para fins de compatibilidade com versões anteriores.) Este comportamento do enumerador poderia causar resultados inesperados. Por exemplo, você deseja enumerar somente arquivos do Excel 2003 e especifica "*.xls". Todavia, o enumerador também retornará arquivos do Excel 2007 porque esses arquivos têm a extensão ".xlsx".
Observação Use caracteres curinga para especificar os arquivos a serem incluídos na coleção.
Totalmente qualificado
Selecione para recuperar o caminho totalmente qualificado de nomes de arquivo. Se forem especificados caracteres curinga na opção Arquivos, os caminhos totalmente qualificados que retornarem corresponderão ao filtro.Apenas nome
Selecione para recuperar só os nomes de arquivo. Se forem especificados caracteres curinga na opção Arquivos, os nomes de arquivo que retornarem corresponderão ao filtro.Nome e extensão
Selecione para recuperar os nomes de arquivo e suas extensões. Se forem especificados caracteres curinga na opção Arquivos, os nomes e extensões que retornarem corresponderão ao filtro.Desviar subpastas
Selecione para incluir as subpastas na enumeração.
Enumerador = Enumerador de Item Foreach
Use o Enumerador de Item Foreach para enumerar itens em uma coleção. Defina os itens na coleção especificando colunas e valores de coluna. As colunas em uma linha definem um item. Por exemplo, um item que especifica os executáveis que uma tarefa Execute Process executa e o diretório de trabalho usado pela tarefa tem duas colunas, uma que lista os nomes de executáveis e outra que lista o diretório de trabalho. O número de linhas determina o número de vezes que o loop é repetido. Se a tabela tiver 10 linhas, o loop será repetido 10 vezes.
Para atualizar as propriedades da tarefa Execute Process, mapeie variáveis para colunas de item usando o índice da coluna. A primeira coluna definida no item do enumerador tem o valor de índice 0, a segunda coluna, 1 e assim por diante. Os valores das variáveis são atualizados com cada repetição do loop. As propriedades do Executable e do WorkingDirectory da tarefa Execute Process podem então ser atualizadas por expressões de propriedade que usam estas variáveis.
Defina os itens na coleção de Itens Foreach
Forneça um valor para cada coluna na tabela.Observação Uma linha nova é adicionada automaticamente à tabela depois que você insere valores nas colunas das linhas.
Observação Se os valores fornecidos não forem compatíveis com o tipo de dados da coluna, o texto aparecerá em vermelho.
Tipo de dados da coluna
Lista o tipo de dados da coluna ativa.Remover
Selecione um item e clique em Remover para removê-lo da lista.Colunas
Clique para configurar o tipo de dados das colunas no item.Tópicos relacionados:, Colunas Para Cada Item.
Enumerador = Enumerador ADO Foreach
Use o enumerador ADO Foreach para enumerar linhas ou tabelas em um objeto ADO ou ADO.NET armazenado em uma variável. Por exemplo, se o Loop Foreach incluir uma tarefa de Script que grava um conjunto de dados em uma variável, você poderá usar o enumerador ADO Foreach para enumerar linhas no conjunto de dados. Se a variável contiver um conjunto de dados ADO.NET, o enumerador poderá ser configurado para enumerar linhas em várias tabelas ou para enumerar tabelas.
Variável de origem de um objeto ADO
Selecione uma variável definida pelo usuário na lista ou clique em <Nova variável...> para criar uma nova variável.Observação A variável deve ter o tipo de dados do Objeto, caso contrário ocorrerá um erro.
Tópicos relacionados:Variáveis do Integration Services, Adicionar VariávelVariáveis do Integration Services, Adicionar Variável
Linhas na primeira tabela
Selecione para enumerar somente linhas na primeira tabela.Linhas em todas as tabelas (somente conjunto de dados ADO.NET)
Selecione para enumerar linhas em todas as tabelas. Esta opção só estará disponível se os objetos a enumerar forem todos membros do mesmo conjunto de dados ADO.NET.Todas as tabelas (somente conjunto de dados ADO.NET)
Selecione para enumerar somente tabelas.
Enumerador = Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach
Use o Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach para enumerar um esquema para uma fonte de dados específica. Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL, você poderá usar o Enumerador de Conjunto de Linhas de Esquema ADO.NET Foreach para enumerar esquemas como as colunas no banco de dados AdventureWorks e a tarefa Execute SQL para obter as permissões do esquema.
Conexão
Selecione um gerenciador de conexões ADO.NET na lista ou clique em <Nova conexão...> para criar um novo gerenciador de conexões ADO.NET.Importante O gerenciador de conexões ADO.NET deve usar um provedor .NET para OLE DB. Se você estiver se conectando com o SQL Server, o provedor indicado é o Cliente Nativo do SQL Server, listado na seção Provedores de .Net para OleDb da caixa de diálogo Gerenciador de conexões.
Tópicos relacionados:Gerenciador de conexões ADO, Configurar Gerenciador de Conexões ADO.NETGerenciador de conexões ADO, Configurar Gerenciador de Conexões ADO.NET
Esquema
Selecione o esquema a enumerar.Definir Restrições
Defina as restrições a serem aplicadas ao esquema especificado.Tópicos relacionados:, Restrições de Esquemas. Restrições de Esquemas
Enumerador = Enumerador Foreach de Variável
Você usa o Enumerador Foreach de Variável para enumerar os objetos enumeráveis na variável especificada. Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL que executa uma consulta e armazena o resultado em uma variável, você poderá usar o Enumerador Foreach de Variável para enumerar os resultados da consulta.
Variável
Selecione uma variável na lista ou clique em <Nova variável...> para criar uma nova variável.Tópicos relacionados:Variáveis do Integration Services, Adicionar VariávelVariáveis do Integration Services, Adicionar Variável
Enumerador = Enumerador NodeList Foreach
Use o enumerador NodeList Foreach para enumerar o conjunto de nós XML resultante da aplicação de uma expressão XPath a um arquivo XML. Por exemplo, se o Loop Foreach incluir uma tarefa Script, você poderá usar o enumerador NodeList Foreach para passar um valor que atende aos critérios da expressão XPath do arquivo XML para a tarefa Script.
A expressão XPath que se aplica ao arquivo XML é a operação XPath externa, armazenada na propriedade OuterXPathString. Se o tipo de enumeração XPath for definido como ElementCollection, o enumerador NodeList Foreach poderá aplicar uma expressão XPath interna, armazenada na propriedade InnerXPathString, a uma coleção de elementos.
Para saber mais sobre como trabalhar com documentos e dados XML, consulte "Employing XML in the .NET Framework" na Biblioteca MSDN.
DocumentSourceType
Selecione o tipo de origem do documento XML. As opções desta propriedade estão listadas na tabela a seguir.Valor
Descrição
Entrada direta
Defina a origem de um documento XML.
Conexão do arquivo
Selecione um arquivo que contém o documento XML.
Variável
Defina a origem de uma variável que contém o documento XML.
DocumentSource
Se DocumentSourceType for definido como Entrada direta, forneça o código XML ou clique no botão de reticências (...) para fornecer o XML usando a caixa de diálogo Editor de Origem de Documento.Se DocumentSourceType for definido como Conexão do arquivo, selecione um Gerenciador de conexões de arquivos ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.
Tópicos relacionados:Gerenciador de conexões de arquivos, Editor do Gerenciador de Conexões de Arquivos
Se DocumentSourceType for definido como Variável, selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.
Tópicos relacionados:Variáveis do Integration Services, Adicionar Variável. Variáveis do Integration Services, Adicionar Variável.
EnumerationType
Selecione um tipo de enumeração na lista. As opções desta propriedade estão listadas na tabela a seguir.Valor
Descrição
Navegador
Enumere usando um XPathNavigator.
Nó
Enumere nós retornados por uma operação XPath.
NodeText
Enumere nós de texto retornados por uma operação XPath.
ElementCollection
Enumera nós de elementos retornados por uma operação XPath.
OuterXPathStringSourceType
Selecione o tipo de origem da cadeia XPath. As opções desta propriedade estão listadas na tabela a seguir.Valor
Descrição
Entrada direta
Defina a origem de um documento XML.
Conexão do arquivo
Selecione um arquivo que contém o documento XML.
Variável
Defina a origem de uma variável que contém o documento XML.
OuterXPathString
Se OuterXPathStringSourceType for definido como Entrada direta, forneça a cadeia de caracteres XPath.Se OuterXPathStringSourceType for definido como Conexão de arquivos, selecione um Gerenciador de conexões de arquivos ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.
Tópicos relacionados:Gerenciador de conexões de arquivos, Editor do Gerenciador de Conexões de Arquivos
Se OuterXPathStringSourceType for definido como Variável, selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.
Tópicos relacionados:Variáveis do Integration Services, Adicionar Variável. Variáveis do Integration Services, Adicionar Variável.
InnerElementType
Se EnumerationType for definido como ElementCollection, selecione o tipo de elemento interno na lista.InnerXPathStringSourceType
Seleciona o tipo de origem da cadeia interna XPath. As opções desta propriedade estão listadas na tabela a seguir.Valor
Descrição
Entrada direta
Defina a origem de um documento XML.
Conexão do arquivo
Selecione um arquivo que contém o documento XML.
Variável
Defina a origem de uma variável que contém o documento XML.
InnerXPathString
Se InnerXPathStringSourceType for definido como Entrada direta, forneça a cadeia de caracteres XPath.Se InnerXPathStringSourceType for definido como Conexão de arquivos, selecione um Gerenciador de conexões de arquivos ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.
Tópicos relacionados:Gerenciador de conexões de arquivos, Editor do Gerenciador de Conexões de Arquivos
Se InnerXPathStringSourceType for definido como Variável, selecione uma variável existente ou clique em <Nova variável...> para criar uma nova variável.
Tópicos relacionados:Variáveis do Integration Services, Adicionar Variável. Variáveis do Integration Services, Adicionar Variável.
Enumerador = Enumerador SMO Foreach
Use o enumerador SMO Foreach para enumerar objetos SMO (SQL Server Management Object). Por exemplo, se o Loop Foreach incluir uma tarefa Execute SQL, você poderá usar o enumerador SMO Foreach para enumerar as tabelas no banco de dados AdventureWorks e executar consultas que contam o número de linhas em cada tabela.
Conexão
Selecione um Gerenciador de conexões ADO.NET existente ou clique em <Nova Conexão...> para criar um gerenciador de conexões.Tópicos relacionados: Gerenciador de conexões ADO.NET, Configurar Gerenciador de Conexões ADO.NETGerenciador de conexões ADO.NET, Configurar Gerenciador de Conexões ADO.NET
Enumerar
Especifique o objeto SMO a enumerar.Procurar
Selecione a enumeração SMO.Tópicos relacionados:, Selecionar Enumeração SMO.