Compartir a través de

  • Artículo

Editor de bucles Foreach (página Colección)

Use la página Colección del cuadro de diálogo Editor de bucles Foreach para especificar el tipo de enumerador y configurarlo.

Para obtener más información acerca del contenedor de bucles Foreach y de cómo configurarlo, vea Contenedor Foreach Loop y Cómo configurar un contenedor de bucles Foreach.

Opciones estáticas

  • Enumerador
    Seleccione el tipo de enumerador de la lista. Esta propiedad tiene las opciones mostradas en la tabla siguiente.

    Valor

    Descripción

    Enumerador de archivos para Foreach

    Enumera archivos. Si selecciona este valor se muestran las opciones dinámicas en la sección Enumerador de archivos para Foreach.

    Enumerador de elementos para Foreach

    Enumera los valores de un elemento. Si selecciona este valor se muestran las opciones dinámicas en la sección Enumerador de elementos para Foreach.

    Enumerador de ADO para Foreach

    Enumera tablas o filas de las tablas. Si selecciona este valor se muestran las opciones dinámicas en la sección Enumerador de ADO para Foreach.

    Enumerador de conjunto de filas del esquema para Foreach de ADO.NET

    Enumera un esquema. Si selecciona este valor se muestran las opciones dinámicas en la sección Enumerador de conjunto de filas del esquema para Foreach de ADO.NET.

    Enumerador de variable para Foreach

    Enumera el valor en una variable. Si selecciona este valor, se muestran las opciones dinámicas en la sección Enumerador de variable para Foreach.

    Enumerador de lista de nodos para Foreach

    Enumera los nodos de un documento XML. Si selecciona este valor, se muestran las opciones dinámicas en la sección Enumerador de lista de nodos para Foreach.

    Enumerador de SMO para Foreach

    Enumera un objeto SMO. Si selecciona este valor, se muestran las opciones dinámicas en la sección Enumerador de SMO para Foreach.

  • Expresiones
    Haga clic o expanda Expresiones para ver la lista de expresiones de propiedad existentes. Haga clic en el botón de puntos suspensivos (…) para agregar una expresión de propiedad para una propiedad de enumerador o para editar y evaluar una expresión de propiedad existente.

    Temas relacionados: Referencia de expresiones de Integration Services, Editor de expresiones de propiedad, Generador de expresiones

Opciones dinámicas de los enumeradores

Enumerador = Enumerador de archivos para Foreach

El enumerador de archivos para Foreach se utiliza para enumerar los archivos de una carpeta. Por ejemplo, si el bucle Foreach incluye una tarea Ejecutar SQL, puede utilizar el enumerador de archivos para Foreach para enumerar los archivos que contienen instrucciones SQL que ejecuta la tarea Ejecutar SQL. El enumerador puede configurarse para incluir subcarpetas.

El contenido de las carpetas y subcarpetas que enumera el enumerador de archivos para Foreach puede cambiar mientras el bucle se ejecuta ya que los procesos externos o las tareas del bucle agregan, cambian el nombre o eliminan archivos mientras el bucle se ejecuta. Esto significa que se pueden producir diversas situaciones inesperadas:

  • Si los archivos se eliminan, una tarea del bucle Foreach puede realizar el trabajo en un conjunto de archivos diferente de los archivos utilizados por las tareas posteriores.

  • Si los archivos se cambian de nombre y un proceso externo agrega archivos automáticamente para sustituir los archivos cuyo nombre ha cambiado, el bucle Foreach puede realizar el trabajo dos veces en el mismo contenido de archivo.

  • Si se agregan archivos, puede resultar difícil determinar los archivos para los que el bucle Foreach ha realizado el trabajo.

  • Carpeta
    Permite especificar la ruta de la carpeta raíz que se va a enumerar.

  • Examinar
    Permite buscar la carpeta raíz.

  • Archivos
    Permite especificar los archivos que se van a enumerar.

    Cuando se especifica una extensión de nombre de archivo, el enumerador también devuelve archivos que tienen la misma extensión con caracteres adicionales anexados. (Este comportamiento es el mismo que el del comando dir en el sistema operativo, que también compara nombres de archivo con formato 8.3 para mantener la compatibilidad con versiones anteriores). Este comportamiento del enumerador podría producir resultados inesperados. Por ejemplo, suponga que desea enumerar sólo archivos de Excel 2003 y especifica "* .xls". Sin embargo, el enumerador también devolverá archivos de Excel 2007 porque esos archivos tienen la extensión, ".xlsx".

    [!NOTA]

    Use caracteres comodín para especificar los archivos que desea incluir en la colección.

  • Completo
    Seleccione esta opción si desea recuperar la ruta completa de los nombres de archivo. Si se especifican caracteres comodín en la opción Archivos, las rutas completas devueltas coinciden con el filtro.

  • Sólo nombre
    Seleccione esta opción si desea recuperar únicamente los nombres. Si se especifican caracteres comodín en la opción Archivos, los nombres de archivo devueltos coinciden con el filtro.

  • Nombre y extensión
    Seleccione esta opción si desea recuperar los nombres y las extensiones de archivo asociadas. Si se especifican caracteres comodín en la opción Archivos, el nombre y extensión de los archivos devueltos coinciden con el filtro.

  • Recorrer subcarpetas
    Seleccione esta opción si desea incluir las subcarpetas en la enumeración.

Enumerador = Enumerador de elementos para Foreach

El enumerador de elementos para Foreach se utiliza para enumerar los elementos de una colección. Los elementos de la colección se definen especificando las columnas y los valores de las columnas. Las columnas de una fila definen un elemento. Por ejemplo, un elemento que especifica los ejecutables que ejecuta una tarea Ejecutar proceso y el directorio de trabajo que utiliza la tarea tiene dos columnas, una que enumera los nombres de los ejecutables y otra que indica el directorio de trabajo. El número de filas determina el número de veces que se repite el bucle. Si la tabla tiene 10 filas, el bucle se repetirá 10 veces.

Para actualizar las propiedades de la tarea Ejecutar proceso, se asignan variables a las columnas de elementos mediante el índice de la columna. La primera columna definida en el elemento enumerador tiene el valor de índice de 0, la segunda columna el valor 1 y así sucesivamente. Los valores de la variable se actualizan con cada repetición del bucle. Las propiedades Executable y WorkingDirectory de la tarea Ejecutar proceso se pueden actualizar mediante expresiones de propiedad que utilizan estas variables.

  • Definir los elementos de la colección Foreach Item
    Proporcione un valor para cada columna de la tabla.

    [!NOTA]

    Se agrega automáticamente una nueva fila a la tabla después de escribir valores en las columnas de una fila.

    [!NOTA]

    Si los valores proporcionados no son compatibles con el tipo de datos de la columna, el texto de muestra en color rojo.

  • Tipo de datos de columna
    Muestra el tipo de datos de la columna activa.

  • Quitar
    Si desea quitar un elemento de la lista, selecciónelo y haga clic en Quitar.

  • Columnas
    Haga clic para configurar el tipo de datos de las columnas del elemento.

    Temas relacionados:Columnas Foreach Item

Enumerador = Enumerador de ADO para Foreach

El enumerador de ADO para Foreach se utiliza para enumerar filas o tablas de un objeto ADO o ADO.NET que está almacenado en una variable. Por ejemplo, si el bucle Foreach incluye una tarea Script que escribe un conjunto de datos en una variable, puede utilizar el enumerador de ADO para Foreach para enumerar las filas del conjunto de datos. Si la variable contiene un conjunto de datos ADO.NET, el enumerador puede configurarse para enumerar filas en varias tablas o para enumerar tablas.

  • Variable de origen de objeto ADO
    Seleccione en la lista una variable definida por el usuario o haga clic en <Nueva variable...> para crear una nueva variable.

    [!NOTA]

    La variable debe tener el tipo de datos Object o, de lo contrario, se producirán errores.

    Temas relacionados:Variables de Integration Services, Agregar variable

  • Filas en la primera tabla
    Seleccione esta opción si desea enumerar sólo las filas de la primera tabla.

  • Filas en todas las tablas (sólo en el conjunto de datos ADO.NET)
    Seleccione esta opción si desea enumerar las filas de todas las tablas. Esta opción sólo está disponible si todos los objetos que se van a enumerar son miembros del mismo conjunto de datos ADO.NET.

  • Todas las tablas (sólo en el conjunto de datos ADO.NET)
    Seleccione esta opción si sólo desea enumerar las tablas.

Enumerador = Enumerador de conjunto de filas del esquema para Foreach de ADO.NET

El enumerador de conjunto de filas del esquema para Foreach de ADO.NET se utiliza para enumerar un esquema para un origen de datos especificado. Por ejemplo, si el bucle Foreach incluye una tarea Ejecutar SQL, puede utilizar el enumerador de conjunto de filas del esquema para Foreach de ADO.NET para enumerar esquemas, como las columnas de la base de datos AdventureWorks, y la tarea Ejecutar SQL para obtener los permisos de esquema.

  • Conexión
    Seleccione un administrador de conexión ADO.NET de la lista o haga clic en <Nueva conexión...> para crear un nuevo administrador de conexión ADO.NET.

    Nota importanteImportante

    El administrador de conexión ADO.NET debe utilizar un proveedor .NET para OLE DB. Si se conecta a SQL Server, el proveedor recomendado es SQL Server Native Client, que aparece enumerado en la sección Proveedores .NET de OleDb del cuadro de diálogo Administrador de conexión.

    Temas relacionados:Administrador de conexión ADO, Configurar el administrador de conexiones ADO.NET

  • Esquema
    Seleccione el esquema que desea enumerar.

  • Establecer restricciones
    Permite establecer las restricciones que se deben aplicar al esquema especificado.

    Temas relacionados:Restricciones de esquema

Enumerador = Enumerador de variable para Foreach

El enumerador de variable para Foreach se utiliza para enumerar los objetos enumerables incluidos en una variable especificada. Por ejemplo, si el bucle Foreach incluye una tarea Ejecutar SQL que ejecuta una consulta y almacena el resultado en una variable, puede utilizar el enumerador de variable para Foreach para enumerar los resultados de la consulta.

Enumerador = Enumerador de lista de nodos para Foreach

El enumerador de lista de nodos para Foreach se utiliza para enumerar el conjunto de nodos XML que resultan de aplicar una expresión XPath a un archivo XML. Por ejemplo, si el bucle Foreach incluye una tarea Script, puede utilizar el enumerador de lista de nodos para Foreach para pasar un valor que coincida con los criterios de la expresión XPath del archivo XML a la tarea Script.

La expresión XPath que se aplica al archivo XML es la operación XPath externa, almacenada en la propiedad OuterXPathString. Si el tipo de enumeración de XPath está establecido en ElementCollection, el enumerador de lista de nodos para Foreach puede aplicar una expresión XPath interna, almacenada en la propiedad InnerXPathString, a una colección de elementos.

Para obtener más información acerca de cómo trabajar con datos y documentos XML, vea el artículo sobre el uso de XML en .NET Framework en MSDN Library.

  • DocumentSourceType
    Seleccione el tipo de origen del documento XML. Esta propiedad tiene las opciones mostradas en la tabla siguiente.

    Valor

    Descripción

    Entrada directa

    Establezca el origen para un documento XML.

    Conexión de archivos

    Seleccione el archivo que contiene el documento XML.

    Variable

    Establezca el origen en una variable que contiene el documento XML.

  • DocumentSource
    Si el valor de DocumentSourceType es Entrada directa, proporcione el código XML o haga clic en el botón de puntos suspensivos (...) para proporcionarlo a través del cuadro de diálogo Editor de origen del documento.

    Si el valor de DocumentSourceType es Conexión de archivos, seleccione un administrador de conexión de archivos o haga clic en <Nueva conexión...> para crear un nuevo administrador de conexión.

    Temas relacionados:Administrador de conexión de archivos, Editor del administrador de conexión de archivos

    Si el valor de DocumentSourceType es Variable, seleccione una variable existente o haga clic en <Nueva variable...> para crear una nueva variable.

    Temas relacionados:Variables de Integration Services, Agregar variable

  • EnumerationType
    Seleccione un tipo de enumeración de la lista. Esta propiedad tiene las opciones mostradas en la tabla siguiente.

    Valor

    Descripción

    Navegador

    Se enumera mediante un objeto XPathNavigator.

    Nodo

    Se enumeran los nodos devueltos por una operación XPath.

    NodeText

    Se enumeran los nodos de texto devueltos por una operación XPath.

    ElementCollection

    Se enumeran los nodos de elemento devueltos por una operación XPath.

  • OuterXPathStringSourceType
    Seleccione el tipo de origen de la cadena XPath. Esta propiedad tiene las opciones mostradas en la tabla siguiente.

    Valor

    Descripción

    Entrada directa

    Establezca el origen para un documento XML.

    Conexión de archivos

    Seleccione el archivo que contiene el documento XML.

    Variable

    Establezca el origen en una variable que contiene el documento XML.

  • OuterXPathString
    Si el valor de OuterXPathStringSourceType es Entrada directa, debe proporcionar la cadena XPath.

    Si el valor de OuterXPathStringSourceType es Conexión de archivos, seleccione un administrador de conexión de archivos o haga clic en <Nueva conexión...> para crear un nuevo administrador de conexión.

    Temas relacionados:Administrador de conexión de archivos, Editor del administrador de conexión de archivos

    Si el valor de OuterXPathStringSourceType es Variable, seleccione una variable existente o haga clic en <Nueva variable...> para crear una nueva variable.

    Temas relacionados:Variables de Integration Services, Agregar variable

  • InnerElementType
    Si el valor de EnumerationType es ElementCollection, seleccione el tipo del elemento interno en la lista.

  • InnerXPathStringSourceType
    Seleccione el tipo de origen de la cadena XPath interna. Esta propiedad tiene las opciones mostradas en la tabla siguiente.

    Valor

    Descripción

    Entrada directa

    Establezca el origen para un documento XML.

    Conexión de archivos

    Seleccione el archivo que contiene el documento XML.

    Variable

    Establezca el origen en una variable que contiene el documento XML.

  • InnerXPathString
    Si el valor de InnerXPathStringSourceType es Entrada directa, debe proporcionar la cadena XPath.

    Si el valor de InnerXPathStringSourceType es Conexión de archivos, seleccione un administrador de conexión de archivos o haga clic en <Nueva conexión...> para crear un nuevo administrador de conexión.

    Temas relacionados:Administrador de conexión de archivos, Editor del administrador de conexión de archivos

    Si el valor de InnerXPathStringSourceType es Variable, seleccione una variable existente o haga clic en <Nueva variable...> para crear una nueva variable.

    Temas relacionados:Variables de Integration Services, Agregar variable.

Enumerador = Enumerador de SMO para Foreach

El enumerador de SMO para Foreach se utiliza para enumerar objetos de Objetos de administración de SQL Server (SMO). Por ejemplo, si el bucle Foreach incluye una tarea Ejecutar SQL, puede utilizar el enumerador de SMO para Foreach para enumerar las tablas de la base de datos AdventureWorks y ejecutar las consultas que realizan el recuento de filas de cada tabla.