ForEachLoop Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bietet einen Container, der einen iterativen Workflow in einem Paket mit der foreach-Iterationsanweisung definiert.
public ref class ForEachLoop sealed : Microsoft::SqlServer::Dts::Runtime::EventsProvider, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx, Microsoft::SqlServer::Dts::Runtime::IDTSSequence
public sealed class ForEachLoop : Microsoft.SqlServer.Dts.Runtime.EventsProvider, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx, Microsoft.SqlServer.Dts.Runtime.IDTSSequence
type ForEachLoop = class
inherit EventsProvider
interface IDTSSequence
interface IDTSPropertiesProvider
interface IDTSPropertiesProviderEx
interface IDTSPackagePath
interface IDTSExecutionPath
Public NotInheritable Class ForEachLoop
Inherits EventsProvider
Implements IDTSExecutionPath, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx, IDTSSequence
- Vererbung
- Implementiert
Hinweise
Zur Laufzeit wird der Steuerfluss im ForEachLoop Container innerhalb des gesamten Paketsteuerungsflusses wiederholt.
Felder
| Name | Beschreibung |
|---|---|
| m_executable |
Die ausführbare Datei. (Geerbt von Executable) |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CreationName |
Gibt die Zeichenkette zurück, mit der eine Instanz des DtsContainer Objekts erstellt wird. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| DebugMode |
Erhält oder setzt einen Boolean, der anzeigt, ob das DtsContainer Objekt im Debug-Modus ist und ob es das OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) Ereignis während des Laufens auslösen sollte. (Geerbt von DtsContainer) |
| DelayValidation |
Erhält oder setzt einen Boolean, der angibt, ob die Validierung der Aufgabe bis zur Laufzeit verzögert wird. Der Standardwert ist „falsch“. (Geerbt von DtsContainer) |
| Description |
Erhält oder setzt die Beschreibung des DtsContainer Objekts. (Geerbt von DtsContainer) |
| Disable |
Ein Boolean, der anzeigt, ob das DtsContainer Objekt deaktiviert ist. (Geerbt von DtsContainer) |
| DisableEventHandlers |
Erhält oder setzt einen Boolean, der anzeigt, ob die Ereignis-Handler auf der Aufgabe deaktiviert sind. (Geerbt von EventsProvider) |
| EventHandlers |
Gibt eine Sammlung von Event Handler-Objekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider) |
| EventInfos |
Gibt eine Sammlung von EventInfo Objekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider) |
| Executables |
Gibt eine Sammlung von Executable Objekten zurück, die von der Data Transformation Run-time-Engine während der Ausführung des verarbeitet werden ForEachLoop. Dieses Feld ist schreibgeschützt. |
| ExecutionDuration |
Gibt einen Wert zurück, der die Zeit angibt, die der Container in Millisekunden für die Ausführung verbracht hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| ExecutionResult |
Gibt einen Wert zurück, der den Erfolg oder das Misserfolg der Ausführung des Objekts DtsContainer anzeigt. (Geerbt von DtsContainer) |
| ExecutionStatus |
Gibt einen Wert zurück, der den aktuellen Status der Ausführung des DtsContainer Objekts zum Zeitpunkt des Aufrufs angibt. (Geerbt von DtsContainer) |
| FailPackageOnFailure |
Erhält oder setzt einen Boolean, der anzeigt, ob das Paket ausfällt, wenn ein Kindcontainer ausfällt. Diese Eigenschaft wird auf Containern verwendet, nicht auf das Paket selbst. (Geerbt von DtsContainer) |
| FailParentOnFailure |
Erhält oder setzt ein |
| ForcedExecutionValue |
Wenn die Eigenschaft ForceExecutionValue auf True gesetzt ist, erhält oder setzt sie einen Wert, der den optionalen Ausführungswert angibt, den das Paket zurückgibt. (Geerbt von DtsContainer) |
| ForceExecutionResult |
Erhält oder setzt einen DTSForcedExecResult Aufzählungswert, der das erzwungene Ausführungsergebnis des Containers angibt. (Geerbt von DtsContainer) |
| ForceExecutionValue |
Erhält oder setzt einen Boolean, der angibt, ob der Ausführungswert des Containers gezwungen werden soll, einen bestimmten Wert zu enthalten. (Geerbt von DtsContainer) |
| ForEachEnumerator |
Erhält oder setzt einen Host für die ForEachEnumerator. |
| HasExpressions |
Erhält einen Wert, der angibt, ob das ForEachLoop Objekt Ausdrücke hat. |
| ID |
Gibt die ID zurück, die ein GUID ist, der DtsContainer. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer) |
| IsDefaultLocaleID |
Ein Boolean, der angibt, ob der Container den Standardstandort verwendet. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| IsolationLevel |
Erhält oder setzt das Isolationsniveau der Transaktion im Objekt DtsContainer . (Geerbt von DtsContainer) |
| LocaleID |
Erhält oder setzt eine Ganzzahl, die die Microsoft Win32-LocaleID® angibt, die verwendet werden soll, wenn das DtsContainer Objekt ausgeführt wird. (Geerbt von DtsContainer) |
| LogEntryInfos |
Gibt ein LogEntryInfos -Objekt zurück. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| LoggingMode |
Erhält oder setzt einen gültigen Wert aus der DTSLoggingMode Aufzählung, der den Logging-Modus des Containers angibt. (Geerbt von DtsContainer) |
| LoggingOptions |
Gibt ein Objekt zurück, das Eigenschaften enthält, die die Filter- und Logging-Ressource für Container anzeigen. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| MaximumErrorCount |
Erhält oder setzt einen Integer-Wert, der die maximale Anzahl von Fehlern angibt, die auftreten können, bevor das DtsContainer Objekt aufhört. (Geerbt von DtsContainer) |
| Name |
Dient zum Abrufen oder Festlegen des Namens der DtsContainer. (Geerbt von DtsContainer) |
| Parent |
Gibt den Elterncontainer zurück. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer) |
| PrecedenceConstraints |
Gibt eine PrecedenceConstraints Sammlung zurück, die alle Vorrangbedingungen enthält, die mit der ForEachLoop. |
| Properties |
Gibt eine Sammlung von DtsProperty Objekten zurück, die mit dem assoziiert sind ForEachLoop. |
| Site |
Bekommt oder setzt die Seite für den Container. (Geerbt von DtsContainer) |
| StartTime |
Gibt die Zeit zurück, zu der der Container mit der Ausführung begonnen hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| StopTime |
Gibt die Zeit zurück, in der der Container die Ausführung beendet hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
| SuspendRequired |
Erhält oder setzt einen Boolean, der anzeigt, ob Aufgaben ausgesetzt werden sollten, wenn sie auf einen Breakpoint stoßen. Dieser Wert wird von der Laufzeit-Engine für Aufgaben und Container festgelegt, wenn ein Breakpoint erreicht wird. (Geerbt von DtsContainer) |
| TransactionOption |
Erhält oder setzt einen DTSTransactionOption Enumerationswert, der angibt, ob der Container an Transaktionen teilnimmt. (Geerbt von DtsContainer) |
| VariableDispenser |
Gibt ein VariableDispenser Objekt zurück, sodass mit dem Container zugeordnete Variablen gesperrt werden können. (Geerbt von DtsContainer) |
| VariableMappings |
Gibt eine ForEachVariableMappings Sammlung zurück, die die Variablenabbildungen für die ForEachLoopenthält. |
| Variables |
Gibt eine Sammlung zurück, die die mit diesem Container verbundenen Variablen enthält. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer) |
Methoden
| Name | Beschreibung |
|---|---|
| AcceptBreakpointManager(BreakpointManager) |
Diese Methode wird von der Laufzeit-Engine aufgerufen, wenn eine Aufgabe oder ein Container erstellt wird, und übermittelt ihr einen BreakpointManager Manager, damit die Aufgabe Breakpoints erstellen, entfernen und überprüfen kann. Diese Methode wird von der Laufzeit aufgerufen und im Code nicht verwendet. (Geerbt von DtsContainer) |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (Geerbt von DtsContainer) |
| Equals(Object) |
Bestimmt, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject) |
| Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object) |
Führt die Anwendung, den Container oder das Paket als Teil eines Paket-Workflows aus. (Geerbt von DtsContainer) |
| GetExecutionPath() |
Erhält den Ausführungspfad für das ForEachLoop Objekt. |
| GetExpression(String) |
Gibt eine Zeichenkette zurück, die den Ausdruck für die angegebene Eigenschaft enthält. Null bedeutet, dass kein Ausdruck zugewiesen wird. |
| GetHashCode() |
Gibt den Hashcode für diesen instance zurück. (Geerbt von DtsObject) |
| GetPackagePath() |
Gibt einen String zurück, der den relativen Pfad zum Paketstandort enthält. |
| LoadFromXML(XmlNode, IDTSEvents) |
Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein als .xmlgespeichertes Paket zu laden, verwenden Sie die Methode LoadPackage(String, IDTSEvents) . (Geerbt von DtsContainer) |
| ResumeExecution() |
Setzt die Ausführung der Aufgabe nach der Pause fort. Die Aufgabe oder der Container wird von der Laufzeit-Engine fortgesetzt. (Geerbt von DtsContainer) |
| SaveToXML(XmlDocument, XmlNode, IDTSEvents) |
Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein Paket als .xmlzu speichern, verwenden Sie die Methode SaveToXml(String, Package, IDTSEvents) . (Geerbt von DtsContainer) |
| SetExpression(String, String) |
Weist den angegebenen Ausdruck der Eigenschaft zu. Geben Sie null an, um einen bestehenden Ausdruck aus der Eigenschaft zu entfernen. |
| SetWrappedExecutable(IDTSExecutable100) |
Gibt das gewickelte ausführbare Objekt zurück. (Geerbt von EventsProvider) |
| SuspendExecution() |
Wird aufgerufen, wenn die ausführbare Datei suspendiert werden muss. Diese Methode wird von der Laufzeit-Engine aufgerufen. (Geerbt von DtsContainer) |
| Validate(Connections, Variables, IDTSEvents, IDTSLogging) |
Ermöglicht es dem Container zu bestimmen, ob er ungültige Einstellungen enthält, die eine erfolgreiche Ausführung verhindern. (Geerbt von DtsContainer) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Disposed |
Fügt einen Ereignishandler hinzu, um auf das Ereignis in der Disposed Komponente zu lauschen. (Geerbt von DtsContainer) |