ForLoop Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

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.

Stellt einen Container bereit, der einen iterativen Workflow in einem Paket definiert, wobei die Iterationsanweisung 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 Steuerungsfluss im ForLoop Container innerhalb des gesamten Paketsteuerungsflusses wiederholt. In jeder Iteration der Schleife wertet der ForLoop Container einen Ausdruck aus und wiederholt seinen Workflow, bis der Ausdruck ausgewertet wird false. Weitere Informationen finden Sie unter For-Schleifencontainerausgewertet wird.

Felder

m_executable

Die ausführbare Datei.

(Geerbt von Executable)

Eigenschaften

AssignExpression	Ruft einen Ausdruck ab, um den Schleifenzähler schrittweise zu erhöhen oder zu verringern, oder legt ihn fest.
CreationName	Gibt die Zeichenfolge zurück, die zum Erstellen einer Instanz des DtsContainer-Objekts verwendet wird. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
DebugMode	Ruft einen booleschen Wert ab, der angibt, ob sich das DtsContainer Objekt im Debugmodus befindet und ob das OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) Ereignis beim Ausführen ausgelöst werden soll, oder legt diesen fest. (Geerbt von DtsContainer)
DelayValidation	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die Überprüfung der Aufgabe bis zur Laufzeit verzögert wird. Der Standardwert ist „FALSE“. (Geerbt von DtsContainer)
Description	Ruft die Beschreibung des DtsContainer-Objekts ab oder legt sie fest. (Geerbt von DtsContainer)
Disable	Ein boolescher Wert, der angibt, ob das DtsContainer Objekt deaktiviert ist. (Geerbt von DtsContainer)
DisableEventHandlers	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die Ereignishandler für den Vorgang deaktiviert sind. (Geerbt von EventsProvider)
EvalExpression	Ruft den Ausdruck ab, der bei jedem Schleifendurchgang ausgewertet wird, oder legt ihn fest.
EventHandlers	Gibt eine Auflistung von Ereignishandlerobjekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider)
EventInfos	Gibt eine Auflistung von EventInfo-Objekten zurück. Dieses Feld ist schreibgeschützt. (Geerbt von EventsProvider)
Executables	Gibt eine Auflistung von ausführbaren Objekten zurück, die während der ForLoop-Iteration verarbeitet werden.
ExecutionDuration	Gibt einen Wert zurück, der die Zeitdauer für die Ausführung des Containers in Millisekunden angibt. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
ExecutionResult	Gibt einen Wert zurück, der angibt, ob die Ausführung des DtsContainer-Objekts erfolgreich oder fehlerhaft war. (Geerbt von DtsContainer)
ExecutionStatus	Gibt einen Wert zurück, der den aktuellen Ausführungsstatus des DtsContainer-Objekts zur Zeit des Aufrufs angibt. (Geerbt von DtsContainer)
FailPackageOnFailure	Ruft einen booleschen Wert ab, der angibt, ob das Paket fehlschlägt, wenn ein untergeordneter Container fehlschlägt, oder legt diesen fest. Diese Eigenschaft wird für Container, nicht aber das Paket selbst verwendet. (Geerbt von DtsContainer)
FailParentOnFailure	Ruft einen `Boolean` Wert ab, der definiert, ob der übergeordnete Container einen Fehler verursacht, wenn ein untergeordneter Container fehlerhaft war, oder legt ihn fest. (Geerbt von DtsContainer)
ForcedExecutionValue	Wenn die ForceExecutionValue Eigenschaft auf True festgelegt ist, ruft einen Wert ab oder legt diesen fest, der den optionalen Ausführungswert angibt, den das Paket zurückgibt. (Geerbt von DtsContainer)
ForceExecutionResult	Ruft einen DTSForcedExecResult-Enumerationswert ab, der das erzwungene Ausführungsergebnis des Containers angibt, oder legt ihn fest. (Geerbt von DtsContainer)
ForceExecutionValue	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Ausführungswert des Containers gezwungen werden soll, einen bestimmten Wert zu enthalten. (Geerbt von DtsContainer)
HasExpressions	Ruft einen Wert ab, der angibt, ob das ForLoop-Objekt Ausdrücke enthält.
ID	Gibt die ID von DtsContainer zurück. Die ID ist eine GUID. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer)
InitExpression	Ruft einen optionalen Initialisierungsausdruck ab oder legt ihn fest.
IsDefaultLocaleID	Ein boolescher Wert, der angibt, ob der Container das Standardgebietsschema verwendet. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
IsolationLevel	Ruft die Isolationsstufe der Transaktion im DtsContainer-Objekt ab oder legt sie fest. (Geerbt von DtsContainer)
LocaleID	Ruft einen Integer-Wert ab, der die Microsoft Win32® LocaleID angibt, die verwendet werden soll, wenn das DtsContainer Objekt ausgeführt wird, oder legt diesen fest. (Geerbt von DtsContainer)
LogEntryInfos	Gibt ein LogEntryInfos-Objekt zurück. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
LoggingMode	Ruft einen gültigen Wert aus der DTSLoggingMode-Enumeration ab, der den Protokollierungsmodus des Containers angibt, oder legt ihn fest. (Geerbt von DtsContainer)
LoggingOptions	Gibt ein Objekt mit Eigenschaften zurück, die die Filterung und Protokollierung von Ressourcen für Container angeben. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
MaximumErrorCount	Dient zum Abrufen oder Festlegen eines Integer-Werts, der die maximale Anzahl von Fehlern angibt, die auftreten können, bevor das DtsContainer Objekt nicht mehr ausgeführt wird. (Geerbt von DtsContainer)
Name	Ruft den Namen der DtsContainer ab oder legt diesen fest. (Geerbt von DtsContainer)
Parent	Gibt den übergeordneten Container zurück. Der Wert ist schreibgeschützt. (Geerbt von DtsContainer)
PrecedenceConstraints	Gibt eine PrecedenceConstraints-Auflistung zurück. Dieses Feld ist schreibgeschützt.
Properties	Gibt einen Satz von Eigenschaften für ForLoop in eine DtsProperties-Auflistung zurück.
Site	Ruft die Site für den Container ab oder legt sie fest. (Geerbt von DtsContainer)
StartTime	Gibt die Uhrzeit zurück, zu der der Container die Ausführung gestartet hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
StopTime	Gibt die Uhrzeit zurück, zu der der Container die Ausführung beendet hat. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)
SuspendRequired	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob Vorgänge angehalten werden sollen, wenn ein Haltepunkt auftritt. Dieser Wert wird von der Runtime-Engine für Tasks und Container festgelegt, wenn ein Breakpoint erreicht wird. (Geerbt von DtsContainer)
TransactionOption	Ruft einen DTSTransactionOption-Enumerationswert ab, der angibt, ob der Container an Transaktionen beteiligt ist, oder legt ihn fest. (Geerbt von DtsContainer)
VariableDispenser	Gibt ein VariableDispenser-Objekt zurück, damit die dem Container zugeordneten Variablen gesperrt werden können. (Geerbt von DtsContainer)
Variables	Gibt eine Auflistung zurück, die die diesem Container zugeordneten Variablen enthält. Diese Eigenschaft ist schreibgeschützt. (Geerbt von DtsContainer)

Methoden

AcceptBreakpointManager(BreakpointManager)	Diese Methode wird von der Runtime-Engine aufgerufen, wenn ein Task oder Container erstellt wird, der an einen BreakpointManager-Manager übergeben wird, damit der Task Breakpoints erstellen, entfernen und deren Status überprüfen kann. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet. (Geerbt von DtsContainer)
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von DtsContainer)
Equals(Object)	Stellt fest, 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 Paketworkflows aus. (Geerbt von DtsContainer)
GetExecutionPath()	Ruft den Ausführungspfad des ForLoop-Objekts ab oder legt ihn fest.
GetExpression(String)	Gibt eine Zeichenfolge 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 diese Instanz zurück. (Geerbt von DtsObject)
GetPackagePath()	Gibt eine Zeichenfolge zurück, die den relativen Pfad zum Paketspeicherort enthält.
LoadFromXML(XmlNode, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode. (Geerbt von DtsContainer)
ResumeExecution()	Setzt die Taskausführung nach einer Unterbrechung fort. Die Runtime-Engine setzt die Ausführung des Tasks oder Containers fort. (Geerbt von DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode. (Geerbt von DtsContainer)
SetExpression(String, String)	Weist der Eigenschaft den angegebenen Ausdruck zu. Geben Sie null an, um einen vorhandenen Ausdruck aus der Eigenschaft zu entfernen.
SetWrappedExecutable(IDTSExecutable100)	Gibt das umschlossene ausführbare Objekt zurück. (Geerbt von EventsProvider)
SuspendExecution()	Wird aufgerufen, wenn das ausführbare Element angehalten werden muss. Diese Methode wird von der Runtime-Engine aufgerufen. (Geerbt von DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Der Container kann feststellen, ob er ungültige Einstellungen enthält, die eine erfolgreiche Ausführung verhindern. (Geerbt von DtsContainer)

Ereignisse

Disposed

Fügt einen Ereignishandler hinzu, der auf das Disposed-Ereignis für die Komponente lauscht.

(Geerbt von DtsContainer)

Gilt für: