Freigeben über

  • Artikel

Foreach-Schleifen-Editor (Seite Auflistung)

Mithilfe der Seite Auflistung des Dialogfeldes Foreach-Schleifen-Editor können Sie den Enumeratortyp angeben und den Enumerator konfigurieren.

Weitere Informationen zum Foreach-Schleifencontainer und zur Vorgehensweise beim Konfigurieren dieses Containers finden Sie unter Foreach-Schleifencontainer und Vorgehensweise: Konfigurieren eines Foreach-Schleifencontainers.

Statische Optionen

  • Enumerator
    Wählen Sie den Enumeratortyp aus der Liste aus. Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar.

    Wert

    Beschreibung

    Foreach-Dateienumerator

    Zählt Dateien auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-Dateienumerator die dynamischen Optionen angezeigt.

    Foreach-Elementenumerator

    Zählt Werte in einem Element auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-Elementenumerator die dynamischen Optionen angezeigt.

    Foreach-ADO-Enumerator

    Zählt Tabellen oder Zeilen in Tabellen auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-ADO-Enumerator die dynamischen Optionen angezeigt.

    Enumerator für Foreach-ADO.NET-Schemarowset

    Zählt ein Schema auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-ADO-Enumerator die dynamischen Optionen angezeigt.

    Foreach-Enumerator für Daten aus Variable

    Zählt den Wert in einer Variable auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-Enumerator für Daten aus Variable die dynamischen Optionen angezeigt.

    Foreach-NodeList-Enumerator

    Zählt Knoten in einem XML-Dokument auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-NodeList-Enumerator die dynamischen Optionen angezeigt.

    Foreach-SMO-Enumerator

    Zählt ein SMO-Objekt auf. Wenn Sie diesen Wert auswählen, werden im Abschnitt Foreach-SMO-Enumerator die dynamischen Optionen angezeigt.

  • Ausdrücke
    Klicken Sie auf die Option Ausdrücke, oder erweitern Sie diese, um die Liste der vorhandenen Eigenschaftsausdrücke anzuzeigen. Klicken Sie auf die Schaltfläche mit den drei Punkten, um einer Enumeratoreigenschaft einen Eigenschaftsausdruck hinzuzufügen, oder um einen vorhandenen Eigenschaftsausdruck zu bearbeiten und auszuwerten.

    Verwandte Themen: Referenzinformationen zu SQL Server Integration Services-Ausdrücken, Eigenschaftsausdrucks-Editor, Ausdrucks-Generator

Enumerator (dynamische Optionen)

Enumerator = Foreach-Dateienumerator

Mithilfe des Foreach-Dateienumerators können Dateien in einem Ordner aufgezählt werden. Wenn die Foreach-Schleife z. B. einen Task SQL ausführen enthält, können Sie mithilfe des Foreach-Dateienumerators Dateien aufzählen, die vom Task SQL ausführen ausgeführte SQL-Anweisungen enthalten. Der Enumerator kann so konfiguriert werden, dass Unterordner in der Aufzählung berücksichtigt werden.

Der Inhalt der Ordner und Unterordner, die der Foreach-Dateienumerator aufzählt, ändert sich möglicherweise beim Durchlaufen der Schleife, da externe Prozesse oder Tasks in der Schleife beim Durchlaufen der Schleife Dateien hinzufügen, umbenennen oder löschen. Dies kann zu unerwarteten Ergebnissen führen:

  • Wenn Dateien gelöscht werden, bearbeitet ein Task in der Foreach-Schleife möglicherweise einen anderen Satz Dateien als den, der von nachfolgenden Tasks bearbeitet wird.

  • Wenn Dateien umbenannt werden und ein externer Prozess Dateien automatisch hinzufügt, um die umbenannten Dateien zu ersetzen, wird derselbe Dateiinhalt möglicherweise zweimal von der Foreach-Schleife bearbeitet.

  • Wenn Dateien hinzugefügt werden, kann es sich als schwierig erweisen, die von der Foreach-Schleife bearbeiteten Dateien zu erkennen.

  • Ordner
    Gibt den Pfad für den Stammordner für die Aufzählung an.

  • Durchsuchen
    Mit dieser Option können Sie den Stammordner suchen.

  • Dateien
    Geben Sie die aufzuzählenden Dateien an.

    Wenn Sie eine Dateierweiterung angeben, gibt der Enumerator auch Dateien mit derselben Erweiterung mit angehängten zusätzlichen Zeichen zurück. (Dieses Verhalten entspricht dem Verhalten des dir-Befehls im Betriebssystem, mit dem 8,3 Dateinamen auf Rückwärtskompatibilität prüft.) Dieses Verhalten des Enumerators könnte unerwartete Ergebnisse verursachen. Angenommen, Sie möchten nur Excel 2003-Dateien auflisten und geben "*.xls" an. Der Enumerator gibt in diesem Fall auch Excel 2007-Dateien zurück, da diese Dateien die Erweiterung, ".xlsx", haben.

    HinweisHinweis

    Sie können Platzhalterzeichen verwenden, um die in der Auflistung zu berücksichtigenden Dateien anzugeben.

  • Vollqualifiziert
    Wählen Sie diese Option aus, um den vollqualifizierten Pfad von Dateinamen abzurufen. Wenn in der Dateioption Platzhalterzeichen angegeben wurden, stimmen die zurückgegebenen vollqualifizierten Pfade mit dem Filter überein.

  • Nur Name
    Wählen Sie diese Option aus, um nur die Dateinamen abzurufen. Wenn in der Dateioption Platzhalterzeichen angegeben wurden, stimmen die zurückgegebenen Dateinamen mit dem Filter überein.

  • Name und Erweiterung
    Wählen Sie diese Option aus, um die Dateinamen und die Dateinamenerweiterungen abzurufen. Wenn in der Dateioption Platzhalterzeichen angegeben wurden, stimmen die zurückgegebenen Dateinamen und Dateierweiterungen mit dem Filter überein.

  • Unterordner durchsuchen
    Wählen Sie diese Option aus, wenn die Unterordner in der Aufzählung berücksichtigt werden sollen.

Enumerator = Foreach-Elementenumerator

Mithilfe des Foreach Item-Numerators können Elemente in einer Auflistung aufgezählt werden. Sie definieren die Elemente in der Auflistung, indem Sie Spalten und Spaltenwerte angeben. Ein Element wird durch die Spalten in einer Zeile definiert. Ein Element, das die von einem Task Prozess ausführen ausgeführten ausführbaren Dateien sowie das vom Task verwendete Arbeitsverzeichnis angibt, verfügt über zwei Spalten. Eine Spalte listet die Namen der ausführbaren Dateien auf und eine andere das Arbeitsverzeichnis. Die Anzahl von Zeilen bestimmt, wie oft die Schleife wiederholt wird. Wenn die Tabelle 10 Zeilen aufweist, wird die Schleife 10-mal wiederholt.

Um die Eigenschaften des Task Prozess ausführen zu aktualisieren, ordnen Sie Elementspalten mithilfe des Spaltenindex Variablen zu. Die erste im Enumeratorelement definierte Spalte verfügt über den Indexwert 0, die zweite über den Wert 1 usw. Die Variablenwerte werden bei jeder Wiederholung der Schleife aktualisiert. Die Eigenschaften Executable und WorkingDirectory des Tasks Prozess ausführen können dann mithilfe von Eigenschaftsausdrücken, die diese Variablen verwenden, aktualisiert werden.

  • Definieren Sie die Elemente für die ForEach-Elementauflistung
    Geben Sie einen Wert für jede Spalte in der Tabelle an.

    HinweisHinweis

    Nachdem Sie die Werte in Zeilenspalten eingegeben haben, wird der Tabelle automatisch eine neue Zeile hinzugefügt.
    HinweisHinweis

    Wenn die angegebenen Werte nicht mit dem Spaltendatentyp kompatibel sind, wird der Text rot angezeigt.

  • Spaltendatentyp
    Führt den Datentyp der aktiven Spalte auf.

  • Entfernen
    Wählen Sie ein Element aus, und klicken Sie anschließend auf Entfernen, um es aus der Liste zu entfernen.

  • Spalten
    Klicken Sie auf diese Option, um den Datentyp der Spalten im Element zu konfigurieren.

    Verwandte Themen:For Each Item ColumnsForEach-Elementspalten

Enumerator = Foreach-ADO-Enumerator

Mithilfe des Foreach-ADO-Enumerators werden Zeilen oder Tabellen in einem in einer Variablen gespeicherten ADO- oder ADO.NET-Objekt aufgezählt. Wenn die Foreach-Schleife z. B. einen Skripttask enthält, mit dem ein Dataset in eine Variable geschrieben wird, können Sie mithilfe des Foreach-ADO-Enumerators die Zeilen im Dataset aufzählen. Wenn die Variable ein ADO.NET-Dataset enthält, kann der Enumerator zum Aufzählen von Zeilen in mehreren Tabellen oder zum Aufzählen von Tabellen konfiguriert werden.

  • ADO-Objektquellvariable
    Wählen Sie eine benutzerdefinierte Variable aus der Liste aus, oder klicken Sie auf <Neue Variable…>, um eine neue Variable zu erstellen.

    HinweisHinweis

    Die Variable muss den Datentyp Objekt besitzen, andernfalls tritt ein Fehler auf.

    Verwandte Themen:Integration Services Variables, Add VariableSQL Server Integration Services-Variablen, Variable hinzufügen

  • Zeilen in der ersten Tabelle
    Wählen Sie diese Option aus, um nur Zeilen in der ersten Tabelle aufzuzählen.

  • Zeilen in allen Tabellen (nur ADO.NET-Dataset)
    Wählen Sie diese Option aus, um Zeilen in allen Tabellen aufzuzählen. Diese Option ist nur verfügbar, wenn die aufzuzählenden Objekte alle Mitglieder desselben ADO.NET-Datasets sind.

  • Alle Tabellen (nur ADO.NET-Dataset)
    Wählen Sie diese Option aus, um nur Tabellen aufzuzählen.

Enumerator = Enumerator für Foreach-ADO.NET-Schemarowset

Mithilfe des Enumerators für Foreach ADO.NET-Schemarowset kann ein Schema für eine angegebene Datenquelle aufgezählt werden. Wenn die Foreach-Schleife z. B. einen Task SQL ausführen enthält, können Sie mit dem Enumerator für Foreach ADO.NET-Schemarowset Schemas aufzählen (beispielsweise die Spalten in der AdventureWorks-Datenbank) und mit dem Task SQL ausführen Schemaberechtigungen abrufen.

  • Verbindung
    Wählen Sie einen ADO.NET-Verbindungs-Manager aus der Liste aus, oder klicken Sie auf <Neue Verbindung..., um einen neuen Verbindungs-Manager zu erstellen.

    Wichtiger HinweisWichtig

    Der ADO.NET-Verbindungs-Manager muss einen .NET-Anbieter für OLE DB verwenden. Wenn Sie eine Verbindung mit SQL Server herstellen, ist der empfohlene Anbieter der SQL Server Native Client, der im Dialogfeld Verbindungs-Manager im Abschnitt .Net-Anbieter für OleDb aufgeführt ist.

    Verwandte Themen:ADO Connection Manager, Configure ADO.NET Connection ManagerADO-Verbindungs-Manager, ADO.NET-Verbindungs-Manager konfigurieren

  • Schema
    Wählen Sie das aufzuzählende Schema aus.

  • Einschränkungen festlegen
    Legen Sie die Einschränkungen fest, die auf das angegebene Schema angewendet werden sollen.

    Verwandte Themen:Schema RestrictionsSchemaeinschränkungen

Enumerator = Foreach-Enumerator für Daten aus Variable

Mithilfe des Foreach-Enumerators für Daten aus Variable werden aufzählbare Objekte in einer angegebenen Variable aufgezählt. Wenn die Foreach-Schleife z. B. einen Task SQL ausführen enthält, der eine Abfrage ausführt und das Ergebnis in einer Variable speichert, können Sie den Foreach-Enumerator für Daten aus Variable zum Aufzählen der Abfrageergebnisse verwenden.

Enumerator = Foreach-NodeList-Enumerator

Mithilfe des Foreach-Nodelist-Enumerators wird der XML-Knotensatz, der das Ergebnis der Anwendung eines XPath-Ausdrucks auf eine XML-Datei ist, aufgezählt. Wenn die Foreach-Schleife einen Skripttask enthält, können Sie mit dem Foreach-NodeList-Enumerator einen Wert, der den Kriterien des XPath-Ausdrucks entspricht, von der XML-Datei an den Skripttask übergeben.

Der XPath-Ausdruck, der auf die XML-Datei angewendet wird, ist der in der OuterXPathString-Eigenschaft gespeicherte äußere XPath-Vorgang. Wenn der XPath-Enumerationstyp auf ElementCollection festgelegt ist, kann der Foreach-NodeList-Enumerator einen inneren in der InnerXPathString-Eigenschaft gespeicherten XPath-Ausdruck auf eine Auflistung von Elementen anwenden.

Weitere Informationen zum Arbeiten mit XML-Dokumenten und Daten finden Sie unter "XML im .NET Framework" in der MSDN Library.

  • DocumentSourceType
    Wählen Sie den Quelltyp des XML-Dokuments aus. Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar.

    Wert

    Beschreibung

    Direkteingabe

    Legen Sie als Quelle ein XML-Dokument fest.

    Dateiverbindung

    Wählen Sie eine Datei aus, die das XML-Dokument enthält.

    Variable

    Legen Sie als Quelle eine Variable fest, die das XML-Dokument enthält.

  • DocumentSource
    Wenn für DocumentSourceType die Option Direct input festgelegt ist, geben Sie den XML-Code an, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (…), um mithilfe des Dialogfeldes Dokumentquellen-Editor XML bereitzustellen.

    Wenn DocumentSourceType auf File connection festgelegt ist, wählen Sie einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung...>, um einen neuen Verbindungs-Manager zu erstellen.

    Verwandte Themen:Dateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

    Wenn DocumentSourceType auf Variable festgelegt ist, wählen Sie eine vorhandene Variable aus, oder klicken Sie auf <Neue Variable...>, um eine neue Variable zu erstellen.

    Verwandte Themen:SQL Server Integration Services-Variablen, Variable hinzufügen.

  • EnumerationType
    Wählen Sie einen Enumerationstyp aus der Liste aus. Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar.

    Wert

    Beschreibung

    Navigator

    Die Aufzählung erfolgt mithilfe eines XPathNavigators.

    Node

    Zählt Knoten auf, die durch einen XPath-Vorgang zurückgegeben wurden.

    NodeText

    Zählt Textknoten auf, die durch einen XPath-Vorgang zurückgegeben wurden.

    ElementCollection

    Zählt Elementknoten auf, die durch einen XPath-Vorgang zurückgegeben wurden.

  • OuterXPathStringSourceType
    Wählen Sie den Quelltyp der XPath-Zeichenfolge aus. Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar.

    Wert

    Beschreibung

    Direkteingabe

    Legen Sie als Quelle ein XML-Dokument fest.

    Dateiverbindung

    Wählen Sie eine Datei aus, die das XML-Dokument enthält.

    Variable

    Legen Sie als Quelle eine Variable fest, die das XML-Dokument enthält.

  • OuterXPathString
    Wenn OuterXPathStringSourceType auf Direct input festgelegt ist, geben Sie die XPath-Zeichenfolge an.

    Wenn OuterXPathStringSourceType auf File connection festgelegt ist, wählen Sie einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung...>, um einen neuen Verbindungs-Manager zu erstellen.

    Verwandte Themen:Dateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

    Wenn OuterXPathStringSourceType auf Variable festgelegt ist, wählen Sie eine vorhandene Variable aus, oder klicken Sie auf <Neue Variable...>, um eine neue Variable zu erstellen.

    Verwandte Themen:SQL Server Integration Services-Variablen, Variable hinzufügen.

  • InnerElementType
    Wenn EnumerationType auf ElementCollection festgelegt ist, wählen Sie den Typ des inneren Elements in der Liste aus.

  • InnerXPathStringSourceType
    Wählen Sie den Quelltyp der inneren XPath-Zeichenfolge aus. Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar.

    Wert

    Beschreibung

    Direkteingabe

    Legen Sie als Quelle ein XML-Dokument fest.

    Dateiverbindung

    Wählen Sie eine Datei aus, die das XML-Dokument enthält.

    Variable

    Legen Sie als Quelle eine Variable fest, die das XML-Dokument enthält.

  • InnerXPathString
    Wenn InnerXPathStringSourceType auf Direct input festgelegt ist, geben Sie die XPath-Zeichenfolge an.

    Wenn InnerXPathStringSourceType auf File connection festgelegt ist, wählen Sie einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung...>, um einen neuen Verbindungs-Manager zu erstellen.

    Verwandte Themen:Dateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

    Wenn InnerXPathStringSourceType auf Variable festgelegt ist, wählen Sie eine vorhandene Variable aus, oder klicken Sie auf <Neue Variable...>, um eine neue Variable zu erstellen.

    Verwandte Themen:Integration Services Variables, Add Variable.SQL Server Integration Services-Variablen, Variable hinzufügen.

Enumerator = Foreach-SMO-Enumerator

Mithilfe des Foreach-SMO-Enumerators werden SQL Server Management Object (SMO)-Objekte aufgezählt. Wenn die Foreach-Schleife z. B. einen Task SQL ausführen enthält, können Sie den Foreach-SMO-Enumerator zum Aufzählen der Tabellen in der AdventureWorks-Datenbank und Ausführen von Abfragen, mit denen die Anzahl von Zeilen pro Tabelle ermittelt wird, verwenden.