Partager via


ForLoop Classe

Définition

Fournit un conteneur qui définit un workflow itératif dans un package, à l’aide de l’instruction d’itération.

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
Héritage
Implémente

Remarques

Au moment de l’exécution, le flux de contrôle dans le ForLoop conteneur est répété dans le flux de contrôle de package global. Dans chaque itération de la boucle, le ForLoop conteneur évalue une expression et répète son workflow jusqu’à falsece que l’expression soit évaluée . Pour plus d’informations, consultez Conteneur de boucles For.

Champs

m_executable

Fichier exécutable.

(Hérité de Executable)

Propriétés

AssignExpression

Obtient ou définit une expression pour incrémenter ou décrémenter le compteur de boucle.

CreationName

Retourne la chaîne utilisée pour créer une instance de l'objet DtsContainer. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
DebugMode

Obtient ou définit une valeur booléenne qui indique si l’objet DtsContainer est en mode débogage et s’il doit déclencher l’événement lors de l’exécution OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) .

(Hérité de DtsContainer)
DelayValidation

Obtient ou définit une valeur booléenne qui indique si la validation de la tâche est retardée jusqu’au moment de l’exécution. La valeur par défaut est false.

(Hérité de DtsContainer)
Description

Obtient ou définit la description de l'objet DtsContainer.

(Hérité de DtsContainer)
Disable

Valeur booléenne qui indique si l’objet DtsContainer est désactivé.

(Hérité de DtsContainer)
DisableEventHandlers

Obtient ou définit une valeur booléenne qui indique si les gestionnaires d’événements sur la tâche sont désactivés.

(Hérité de EventsProvider)
EvalExpression

Obtient ou définit l'expression évaluée à chaque passe de la boucle.

EventHandlers

Retourne une collection d'objets de gestionnaires d'événements. Ce champ est en lecture seule.

(Hérité de EventsProvider)
EventInfos

Retourne une collection d'objets EventInfo. Ce champ est en lecture seule.

(Hérité de EventsProvider)
Executables

Retourne une collection d'objets exécutables traités lors de l'itération ForLoop.

ExecutionDuration

Retourne une valeur qui indique la durée d'exécution du conteneur en millisecondes. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
ExecutionResult

Retourne une valeur qui indique la réussite ou l'échec de l'exécution de l'objet DtsContainer.

(Hérité de DtsContainer)
ExecutionStatus

Retourne une valeur qui indique l'état actuel de l'exécution de l'objet DtsContainer au moment de l'appel.

(Hérité de DtsContainer)
FailPackageOnFailure

Obtient ou définit une valeur booléenne qui indique si le package échoue lorsqu’un conteneur enfant échoue. Cette propriété est utilisée sur les conteneurs, non sur le package lui-même.

(Hérité de DtsContainer)
FailParentOnFailure

Obtient ou définit une valeur Boolean qui définit si le conteneur parent échoue en cas d'échec d'un conteneur enfant.

(Hérité de DtsContainer)
ForcedExecutionValue

Si la propriété a la ForceExecutionValue valeur True, obtient ou définit une valeur qui spécifie la valeur d’exécution facultative retournée par le package.

(Hérité de DtsContainer)
ForceExecutionResult

Obtient ou définit une valeur d'énumération DTSForcedExecResult qui spécifie le résultat d'exécution forcé du conteneur.

(Hérité de DtsContainer)
ForceExecutionValue

Obtient ou définit une valeur booléenne qui indique si la valeur d’exécution du conteneur doit être forcée de contenir une valeur particulière.

(Hérité de DtsContainer)
HasExpressions

Obtient une valeur qui indique si l'objet ForLoop possède des expressions.

ID

Retourne l'ID, qui est un GUID, de l'objet DtsContainer. Cette valeur est en lecture seule.

(Hérité de DtsContainer)
InitExpression

Obtient ou définit une expression d'initialisation facultative.

IsDefaultLocaleID

Valeur booléenne qui indique si le conteneur utilise les paramètres régionaux par défaut. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
IsolationLevel

Obtient ou définit le niveau d'isolation de la transaction dans l'objet DtsContainer.

(Hérité de DtsContainer)
LocaleID

Obtient ou définit un entier qui indique l’ID de paramètres régionaux Microsoft Win32® à utiliser lors de l’exécution de l’objet DtsContainer .

(Hérité de DtsContainer)
LogEntryInfos

Retourne un objet LogEntryInfos. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
LoggingMode

Obtient ou définit une valeur valide à partir de l'énumération DTSLoggingMode qui indique le mode de journalisation du conteneur.

(Hérité de DtsContainer)
LoggingOptions

Retourne un objet contenant des propriétés qui indiquent la ressource de filtrage et de journalisation des conteneurs. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
MaximumErrorCount

Obtient ou définit une valeur Integer qui indique le nombre maximal d’erreurs pouvant se produire avant que l’objet DtsContainer cesse de s’exécuter.

(Hérité de DtsContainer)
Name

Obtient ou définit le nom de l'objet DtsContainer.

(Hérité de DtsContainer)
Parent

Retourne le conteneur parent. Cette valeur est en lecture seule.

(Hérité de DtsContainer)
PrecedenceConstraints

Retourne une collection PrecedenceConstraints. Ce champ est en lecture seule.

Properties

Retourne un jeu de propriétés pour l'objet ForLoop dans une collection DtsProperties.

Site

Obtient ou définit le site du conteneur.

(Hérité de DtsContainer)
StartTime

Retourne l'heure à laquelle le conteneur a commencé l'exécution. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
StopTime

Retourne l'heure à laquelle le conteneur a terminé l'exécution. Cette propriété est en lecture seule.

(Hérité de DtsContainer)
SuspendRequired

Obtient ou définit une valeur booléenne qui indique si les tâches doivent s’interrompre lorsqu’elles rencontrent un point d’arrêt. Cette valeur est définie par le moteur du runtime pour les tâches et les conteneurs lorsqu'un point d'arrêt est rencontré.

(Hérité de DtsContainer)
TransactionOption

Obtient ou définit une valeur d'énumération DTSTransactionOption qui indique si le conteneur participe aux transactions.

(Hérité de DtsContainer)
VariableDispenser

Retourne un objet VariableDispenser afin de pouvoir verrouiller les variables associées au conteneur.

(Hérité de DtsContainer)
Variables

Retourne une collection qui contient les variables associées à ce conteneur. Cette propriété est en lecture seule.

(Hérité de DtsContainer)

Méthodes

AcceptBreakpointManager(BreakpointManager)

Cette méthode est appelée par le moteur d'exécution lors de la création d'une tâche ou d'un conteneur, et lui transmet un gestionnaire BreakpointManager pour autoriser la tâche visant à créer, supprimer et vérifier l'état des points d'arrêt. Cette méthode est appelée par le runtime et n'est pas utilisée dans le code.

(Hérité de DtsContainer)
Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

(Hérité de DtsContainer)
Equals(Object)

Détermine si les deux instances d'objet sont égales.

(Hérité de DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)

Exécute l'application, le conteneur ou le package dans le cadre d'un flux de travail de package.

(Hérité de DtsContainer)
GetExecutionPath()

Obtient le chemin d'exécution de l'objet ForLoop.

GetExpression(String)

Retourne une chaîne qui contient l’expression de la propriété spécifiée. Null signifie qu’aucune expression n’est affectée.

GetHashCode()

Retourne le code de hachage de cette instance.

(Hérité de DtsObject)
GetPackagePath()

Retourne une chaîne qui contient le chemin d’accès relatif à l’emplacement du package.

LoadFromXML(XmlNode, IDTSEvents)

Cette méthode ne peut pas être appelée par votre code d'application. Pour charger un package enregistré en tant que .xml, utilisez la méthode LoadPackage(String, IDTSEvents).

(Hérité de DtsContainer)
ResumeExecution()

Reprend l'exécution de la tâche après une suspension. Le moteur du runtime reprend la tâche ou le conteneur.

(Hérité de DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)

Cette méthode ne peut pas être appelée par votre code d'application. Pour enregistrer un package en tant que .xml, utilisez la méthode SaveToXml(String, Package, IDTSEvents).

(Hérité de DtsContainer)
SetExpression(String, String)

Affecte l'expression spécifiée à la propriété. Spécifiez null pour supprimer une expression existante de la propriété.

SetWrappedExecutable(IDTSExecutable100)

Retourne l'objet exécutable encapsulé.

(Hérité de EventsProvider)
SuspendExecution()

Appelée lorsque l'exécutable doit s'interrompre. Cette méthode est appelée par le moteur du runtime.

(Hérité de DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)

Permet au conteneur de déterminer s'il contient des paramètres non valides qui l'empêcheront de s'exécuter correctement.

(Hérité de DtsContainer)

Événements

Disposed

Ajoute un gestionnaire d'événements pour écouter l'événement Disposed sur le composant.

(Hérité de DtsContainer)

S’applique à