Foreach-Schleifen-Editor (Seite Auflistung)

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.

  Hinweis

  Sie können Platzhalterzeichen (*) verwenden, um die in der Sammlung zu berücksichtigenden Dateien anzugeben. Wenn Sie Dateien einschließen möchten, in deren Namen "abc" vorkommt, verwenden Sie den folgenden Filter: *abc*. 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 Abwärtskompatibilität geprüft werden.) 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. Mithilfe eines Ausdrucks können Sie die in eine Sammlung aufzunehmenden Dateien angeben. Erweitern Sie auf der Seite Sammlung den Eintrag Ausdrücke, wählen Sie die FileSpec-Eigenschaft aus, und klicken Sie auf die Schaltfläche mit den Auslassungspunkten (…), um den Eigenschaftsausdruck hinzuzufügen. Weitere Informationen zur dynamischen Auswahl angegebener Dateien finden Sie unter Von SSIS dynamisch festgelegte Dateimaske: FileSpec

• 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.

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.

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

  Hinweis
  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:ForEach-Elementspalten

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.

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

  Verwandte Themen:SQL 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.

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 AdventureWorks2008R2-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.

  Wichtig
  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-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:Schemaeinschränkungen

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.

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

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

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 Dialogfelds 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:SQL Server Integration Services-Variablen, Variable hinzufügen.

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 AdventureWorks2008R2-Datenbank und Ausführen von Abfragen, mit denen die Anzahl von Zeilen pro Tabelle ermittelt wird, verwenden.

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

  Verwandte Themen: ADO.NET-Verbindungs-Manager, ADO.NET-Verbindungs-Manager konfigurieren

• Aufzählen
  Geben Sie das aufzuzählende SMO-Objekt an.

• Durchsuchen
  Wählen Sie die SMO-Enumeration aus.

  Verwandte Themen:SMO-Enumeration auswählen