• Article

Éditeur de boucle Foreach (page de collection)

Utilisez la page Collectionde la boîte de dialogue Éditeur de boucle Foreach afin de préciser le type d'énumérateur et configurer ce dernier.

Pour en savoir plus sur le conteneur de boucle Foreach et sur sa configuration, consultez Conteneur de boucles Foreach et Procédure : configurer un conteneur de boucles Foreach.

Options statiques

  • Énumérateur
    Sélectionnez le type d'énumérateur dans la liste. Cette propriété dispose des options répertoriées dans le tableau suivant.

    Valeur

    Description

    Foreach File Enumerator

    Permet d'énumérer les fichiers. Si cette valeur est sélectionnée, les options dynamiques s'affichent dans la section Foreach File Enumerator.

    Foreach Item Enumerator

    Permet d'énumérer les valeurs issues d'un élément. Si cette valeur d'énumérateur est sélectionnée, les options dynamiques s'affichent dans la section Foreach Item Enumerator.

    Foreach ADO Enumerator

    Permet d'énumérer les tables ou les lignes au sein de tables. Si cette valeur est sélectionnée, les options dynamiques s'affichent dans la section Foreach ADO Enumerator.

    Foreach ADO.NET Schema Rowset Enumerator

    Permet d'énumérer un schéma. Si cette valeur est sélectionnée, les options dynamiques s'affichent dans la section Foreach ADO.NET Enumerator.

    Foreach From Variable Enumerator

    Permet d'énumérer la valeur d'une variable. Si cette valeur est sélectionnée, les options dynamiques s'affichent dans la section Énumérateur Foreach à partir d'une variable.

    Foreach Nodelist Enumerator

    Permet d'énumérer les nœuds d'un document XML. Si cette valeur est sélectionnée, les options dynamiques s'affichent dans la section Énumérateur Foreach NodeList.

    Foreach SMO Enumerator

    Permet d'énumérer un objet SMO. Si cette valeur d'énumérateur est sélectionnée, les options dynamiques s'affichent dans la section Énumérateur Foreach SMO.

  • Expressions
    Cliquez sur Expressions ou développez ce groupe pour afficher la liste des expressions relatives aux propriétés. Cliquez sur le bouton représenté par les points de suspension (…) pour ajouter une expression de propriété correspondant à une propriété d'énumérateur ou modifiez et évaluez une expression de propriété existante.

    Rubriques connexes : Informations de référence des expressions Integration Services, Éditeur d'expressions de la propriété, Générateur d'expressions

Options dynamiques portant sur les énumérateurs

Enumerator = Foreach File Enumerator

Vous utilisez l'énumérateur Foreach File pour énumérer les fichiers d'un dossier. Par exemple, si la boucle Foreach inclut une tâche SQL, vous pouvez utiliser l'énumérateur Foreach File pour énumérer les fichiers qui contiennent les instructions SQL que la tâche SQL exécute. L'énumérateur peut être configuré pour inclure les sous-dossiers.

Le contenu des dossiers et des sous-dossiers que l'énumérateur Foreach File énumère peut changer pendant l'exécution de la boucle, car les processus externes ou les tâches de la boucle ajoutent, renomment ou suppriment les fichiers pendant l'exécution de la boucle. Cela signifie qu'un certain nombre de situations inattendues peuvent se produire :

  • si des fichiers sont supprimés, une tâche de la boucle Foreach peut travailler sur un jeu de fichiers différent des fichiers utilisés par les tâches à venir ;

  • si des fichiers sont renommés et qu'un processus externe ajoute automatiquement des fichiers pour remplacer les fichiers renommés, la boucle Foreach peut travailler deux fois sur le même contenu de fichier ;

  • si des fichiers sont ajoutés, il peut être difficile de déterminer pour quels fichiers la boucle Foreach a effectué le travail.

  • Dossier
    Permet d'indiquer le chemin du dossier racine à énumérer.

  • Parcourir
    Permet de rechercher et de spécifier le chemin d'accès du dossier racine.

  • Fichiers
    Permet de spécifier les fichiers à énumérer.

    Lorsque vous spécifiez une extension de nom de fichier, l'énumérateur retourne également des fichiers qui ont la même extension avec des caractères supplémentaires ajoutés. (Il s'agit du même comportement que celui de la commande dir dans le système d'exploitation, qui compare également les noms de fichiers 8.3 pour la compatibilité descendante.) Ce comportement de l'énumérateur peut générer des résultats inattendus. Par exemple, vous souhaitez énumérer uniquement des fichiers Excel 2003 et vous spécifiez "*.xls". Toutefois, l'énumérateur retournera également des fichiers Excel 2007 parce que ces fichiers ont l'extension ".xlsx".

    [!REMARQUE]

    Utilisez le caractère étoile (*) pour indiquer les fichiers à inclure à la collection.

  • Complet
    Permet de récupérer les chemins d'accès complets des noms de fichiers indiqués. Si des caractères étoile (*) sont mentionnés dans l'option Fichiers, les chemins d'accès complets retournés par la fonction sont ceux correspondant au filtre spécifié.

  • Nom uniquement
    Permet de ne récupérer que les noms de fichiers. Si des caractères étoile (*) sont mentionnés dans l'option Fichiers, les noms de fichiers retournés par la fonction sont ceux correspondant au filtre spécifié.

  • Nom et extension
    Permet de retrouver le nom et l'extension des fichiers. Si des caractères étoile (*) sont mentionnés dans l'option Fichiers, les noms et extension de fichiers retournés par la fonction sont ceux correspondant au filtre spécifié.

  • Parcourir les sous-dossiers
    Permet d'inclure les sous-dossiers dans l'énumération.

Enumerator = Foreach Item Enumerator

Vous utilisez l'énumérateur Foreach Item pour énumérer les éléments d'un dossier. Vous définissez les éléments de la collection en spécifiant les colonnes et les valeurs de colonne. Les colonnes d'une ligne définissent un élément. Par exemple, un élément qui spécifie les exécutables qu'une tâche Exécuter le processus lance et le répertoire de travail que la tâche utilise a deux colonnes, une qui dresse la liste des noms d'exécutables et une qui indique le répertoire de travail. Le nombre de lignes détermine le nombre de répétitions de la boucle. Si la table a 10 lignes, la boucle se répète 10 fois.

Pour mettre à jour les propriétés de la tâche Exécuter le processus, vous associez des variables à des colonnes d'élément en utilisant l'index de la colonne. La première colonne définie dans l'élément de l'énumérateur a la valeur d'index 0, la deuxième colonne 1, etc. Les valeurs de variables sont mises à jour à chaque répétition de la boucle. Les propriétés Executable et WorkingDirectory de la tâche Exécuter le processus peuvent ensuite être mises à jour par les expressions de propriété qui utilisent ces variables.

  • Définissez les éléments de la collection For Each Item
    Permet de fournir une valeur pour chaque colonne de la table.

    [!REMARQUE]

    Une nouvelle ligne est automatiquement ajoutée à la table dès que vous saisissez des valeurs dans les colonnes composant les lignes.

    [!REMARQUE]

    Si une valeur indiquée n'est pas compatible avec le type de données de la colonne dans laquelle vous insérez la valeur, le texte s'affiche alors en rouge.

  • Type de données de la colonne
    Permet d'afficher le type de données de la colonne active.

  • Supprimer
    Permet de sélectionner et de cliquer sur Supprimer pour supprimer un élément de la liste.

  • Colonnes
    Cliquez pour configurer le type de données des colonnes constituant l'élément.

    Rubriques connexes :Colonnes For Each Item

Enumerator = Foreach ADO Enumerator

Vous utilisez l'énumérateur ADO Foreach pour énumérer les lignes ou les tables d'un objet ADO ou ADO.NET qui est stocké dans une variable. Par exemple, si la boucle Foreach inclut une tâche de script qui écrit un dataset dans une variable, vous pouvez utiliser l'énumérateur ADO Foreach pour énumérer les lignes du dataset. Si la variable contient un dataset ADO.NET, l'énumérateur peut être configuré pour énumérer les lignes de plusieurs tables ou pour énumérer des tables.

  • Variable source de l'objet ADO
    Permet de sélectionner une variable personnalisée dans la liste ou de cliquer sur <Nouvelle variable...> afin d'en créer une.

    [!REMARQUE]

    La variable doit être de type Objet ; dans le cas contraire, une erreur se produit.

    Rubriques connexes :Variables Integration Services, Ajouter une variable

  • Lignes dans la première table
    Permet de n'énumérer que les lignes de la première table.

  • Lignes dans toutes les tables (dataset ADO.Net uniquement)
    Permet d'énumérer les lignes de toutes les tables. Cette option n'est disponible que si les objets à énumérer sont tous des membres du même dataset ADO.NET.

  • Toutes les tables (dataset ADO.Net uniquement)
    Permet de n'énumérer que les tables.

Enumerator = Foreach ADO.NET Schema Rowset Enumerator

Vous utilisez l'énumérateur d'ensemble de lignes du schéma ADO.NET Foreach pour énumérer un schéma pour une source de données spécifiée. Par exemple, si la boucle Foreach inclut une tâche d'exécution SQL, vous pouvez utiliser l'énumérateur d'ensemble de lignes du schéma ADO.NET Foreach pour énumérer des schémas tels que les colonnes de la base de données AdventureWorks, et la tâche d'exécution SQL pour obtenir les autorisations de schéma.

  • Connexion
    Permet de sélectionner un gestionnaire de connexions ADO.NET dans la liste ou de cliquer sur <Nouvelle connexion...> afin d'en créer un.

    Important

    Le gestionnaire de connexions ADO.NET doit utiliser un fournisseur .NET pour OLE DB. Lors de la connexion à SQL Server, il est recommandé d'utiliser le fournisseur SQL Server Native Client, répertorié dans la section Fournisseurs .Net pour OleDb de la boîte de dialogue Gestionnaire de connexions.

    Rubriques connexes :Gestionnaire de connexions ADO, Configurer le gestionnaire de connexions ADO.NET

  • Schéma
    Permet d'indiquer le schéma à énumérer.

  • Définir les restrictions
    Permet de définir les restrictions s'appliquant au schéma indiqué.

    Rubriques connexes :Restrictions de schéma

Enumerator = Foreach From Variable Enumerator

L'énumérateur Foreach à partir d'une variable permet d'énumérer les objets énumérables contenus dans la variable spécifiée. Par exemple, si la boucle Foreach inclut une tâche d'exécution SQL qui exécute une requête et enregistre le résultat dans une variable, vous pouvez utiliser l'énumérateur Foreach à partir d'une variable pour énumérer les résultats de la requête.

Enumerator = Foreach NodeList Enumerator

L'énumérateur Foreach Nodelist permet d'énumérer un ensemble de nœuds XML qui résulte de l'application d'une expression XPath à un fichier XML. Par exemple, si la boucle Foreach inclut une tâche de script, vous pouvez utiliser l'énumérateur Foreach NodeList pour transmettre une valeur qui correspond aux critères de l'expression XPath du fichier XML à la tâche de script.

L'expression XPath qui s'applique au fichier XML est l'opération XPath externe, stockée dans la propriété OuterXPathString. Si le type d'énumération XPath a la valeur ElementCollection, l'énumérateur Foreach NodeList peut appliquer une expression XPath interne, stockée dans la propriété InnerXPathString, à une collection d'éléments.

Pour en savoir plus sur l'utilisation de documents et de données XML, consultez « Employing XML in the .NET Framework » (en anglais) dans MSDN Library.

  • DocumentSourceType
    Permet de sélectionner le type source correspondant au document XML. Cette propriété dispose des options répertoriées dans le tableau suivant.

    Valeur

    Description

    Entrée directe

    Permet de définir la source sur un document XML.

    Connexion de fichiers

    Permet de sélectionner un fichier contenant le document XML.

    Variable

    Permet de définir la source sur une variable contenant le document XML.

  • DocumentSource
    Si DocumentSourceType est défini sur Entrée directe, indiquez le code XML ou cliquez sur le bouton représentant les points de suspension (…) pour fournir le code XML nécessaire par le biais de la boîte de dialogue Éditeur de source de document.

    Si DocumentSourceType est défini sur Connexion de fichiers, sélectionnez dans ce cas un gestionnaire de connexions de fichiers ou cliquez sur <Nouvelle connexion...> afin d'en créer un.

    Rubriques connexes :Gestionnaire de connexions de fichiers, Éditeur du gestionnaire de connexions de fichiers

    Si DocumentSourceType est défini sur Variable, sélectionnez alors une variable existante ou cliquez sur <Nouvelle variable...> afin d'en créer une.

    Rubriques connexes :Variables Integration Services, Ajouter une variable

  • EnumerationType
    Permet de sélectionner le type d'énumérateur dans la liste. Cette propriété dispose des options répertoriées dans le tableau suivant.

    Valeur

    Description

    Navigator

    Permet d'énumérer par le biais d'un XPathNavigator.

    Node

    Permet d'énumérer les nœuds retournés par une opération XPath.

    NodeText

    Permet d'énumérer les nœuds texte retournés par une opération XPath.

    ElementCollection

    Permet d'énumérer les nœuds des éléments retournés par une opération XPath.

  • OuterXPathStringSourceType
    Permet de sélectionner le type source correspondant à une chaîne XPath. Cette propriété dispose des options répertoriées dans le tableau suivant.

    Valeur

    Description

    Entrée directe

    Permet de définir la source sur un document XML.

    Connexion de fichiers

    Permet de sélectionner un fichier contenant le document XML.

    Variable

    Permet de définir la source sur une variable contenant le document XML.

  • OuterXPathString
    Si OuterXPathStringSourceType est défini sur Entrée directe, fournissez une chaîne XPath.

    Si OuterXPathStringSourceType est défini sur Connexion de fichiers, sélectionnez dans ce cas un gestionnaire de connexions de fichiers ou cliquez sur <Nouvelle connexion...> afin d'en créer un.

    Rubriques connexes :Gestionnaire de connexions de fichiers, Éditeur du gestionnaire de connexions de fichiers

    Si OuterXPathStringSourceType est défini sur Variable, sélectionnez alors une variable existante ou cliquez sur <Nouvelle variable...> afin d'en créer une.

    Rubriques connexes :Variables Integration Services, Ajouter une variable

  • InnerElementType
    Si EnumerationType est défini sur ElementCollection, sélectionnez le type d'élément interne dans la liste.

  • InnerXPathStringSourceType
    Permet de sélectionner le type source correspondant à une chaîne XPath interne. Cette propriété dispose des options répertoriées dans le tableau suivant.

    Valeur

    Description

    Entrée directe

    Permet de définir la source sur un document XML.

    Connexion de fichiers

    Permet de sélectionner un fichier contenant le document XML.

    Variable

    Permet de définir la source sur une variable contenant le document XML.

  • InnerXPathString
    Si InnerXPathStringSourceType est défini sur Entrée directe, fournissez une chaîne XPath.

    Si InnerXPathStringSourceType est défini sur Connexion de fichiers, sélectionnez dans ce cas un gestionnaire de connexions de fichiers ou cliquez sur <Nouvelle connexion...> afin d'en créer un.

    Rubriques connexes :Gestionnaire de connexions de fichiers, Éditeur du gestionnaire de connexions de fichiers

    Si InnerXPathStringSourceType est défini sur Variable, sélectionnez alors une variable existante ou cliquez sur <Nouvelle variable...> afin d'en créer une.

    Rubriques connexes :Variables Integration Services, Ajouter une variable.

Enumerator = Foreach SMO Enumerator

L'énumérateur Foreach SMO permet d'énumérer des objets SQL-SMO (SQL Server Management Object). Par exemple, si la boucle Foreach inclut une tâche d'exécution SQL, vous pouvez utiliser l'énumérateur Foreach SMO pour énumérer les tables de la base de données AdventureWorks et exécuter des requêtes qui comptent le nombre de lignes dans chaque table.