ForLoop Klasse

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Stellt einen Container bereit, der einen iterativen Workflow in einem Paket definiert, wobei die for Iteration-Anweisung verwendet wird.

public ref class ForLoop 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 ForLoop : 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 ForLoop = class
    inherit EventsProvider
    interface IDTSSequence
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

Public NotInheritable Class ForLoop
Inherits EventsProvider
Implements IDTSExecutionPath, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx, IDTSSequence

Vererbung

Object

DtsObject

Executable

DtsContainer

EventsProvider

ForLoop

Implementiert

IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

Hinweise

Zur Laufzeit wird der Steuerfluss im ForLoop Container innerhalb des gesamten Paketsteuerungsflusses wiederholt. In jeder Iteration der Schleife bewertet der Container ForLoop einen Ausdruck und wiederholt seinen Workflow, bis der Ausdruck zu auswertet false. Weitere Informationen finden Sie unter For-Schleifencontainerausgewertet wird.

Felder

Name	Beschreibung
m_executable	Die ausführbare Datei. (Geerbt von Executable)

Eigenschaften

Name	Beschreibung
AssignExpression	Erhält oder setzt einen Ausdruck, um den Schleifenzähler zu erhöhen oder zu decrementieren.
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)
EvalExpression	Erhält oder setzt den Ausdruck, der bei jedem Durchgang der Schleife ausgewertet wird.
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 ausführbarer Objekte zurück, die während der ForLoop Iteration verarbeitet werden.
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 Boolean Container, der definiert, ob der Elterncontainer ausfällt, wenn ein Kindcontainer ausfällt. (Geerbt von DtsContainer)
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)
HasExpressions	Erhält einen Wert, der angibt, ob das ForLoop Objekt Ausdrücke hat.
ID	Gibt die ID zurück, die ein GUID ist, der DtsContainer. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer)
InitExpression	Erhält oder setzt einen optionalen Initialisierungsausdruck.
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 Auflistung zurück. Dieses Feld ist schreibgeschützt.
Properties	Gibt eine Menge von Eigenschaften für die ForLoop in eine DtsProperties Sammlung zurück.
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)
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 ForLoop 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)