ForLoop Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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’à false
ce 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 |
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) |