ForLoop 类

定义

命名空间:

Microsoft.SqlServer.Dts.Runtime

程序集:

Microsoft.SqlServer.ManagedDTS.dll

提供一个容器，在包中定义迭代工作流，使用for迭代语句。

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

继承

Object

DtsObject

Executable

DtsContainer

EventsProvider

ForLoop

实现

IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

注解

运行时，容器中的 ForLoop 控制流在整个包控制流中重复执行。 在循环的每次迭代中， ForLoop 容器会评估一个表达式并重复其工作流，直到表达式得到 false。 有关详细信息，请参阅 For 循环容器。

字段

名称	说明
m_executable	可执行文件。 (继承自 Executable)

属性

名称	说明
AssignExpression	获取或设置一个表达式，以增加或减少循环计数器。
CreationName	返回用于创建该对象实例 DtsContainer 的字符串。 此属性为只读。 (继承自 DtsContainer)
DebugMode	获取或设置一个布尔值，指示对象是否 DtsContainer 处于调试模式，以及运行时是否应触发 OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 事件。 (继承自 DtsContainer)
DelayValidation	获得或设置一个布尔值，指示任务验证是否延迟到运行时。 默认值为 false。 (继承自 DtsContainer)
Description	获取或设置对象的 DtsContainer 描述。 (继承自 DtsContainer)
Disable	一个布尔值，表示该对象是否 DtsContainer 被禁用。 (继承自 DtsContainer)
DisableEventHandlers	获取或设置一个布尔值，指示任务中的事件处理程序是否被禁用。 (继承自 EventsProvider)
EvalExpression	获得或设置每次循环时计算的表达式。
EventHandlers	返回一组事件处理对象。 此字段是只读的。 (继承自 EventsProvider)
EventInfos	返回一组 EventInfo 对象。 此字段是只读的。 (继承自 EventsProvider)
Executables	返回一组在迭代过程中 ForLoop 处理的可执行对象。
ExecutionDuration	返回一个值，表示容器执行时耗时的时间，单位为毫秒。 此属性为只读。 (继承自 DtsContainer)
ExecutionResult	返回一个表示对象执行 DtsContainer 成功或失败的值。 (继承自 DtsContainer)
ExecutionStatus	返回一个值，表示调用时对象执行状态的当前状态 DtsContainer 。 (继承自 DtsContainer)
FailPackageOnFailure	获得或设置一个布尔值，表示子容器失败时包是否失败。 该特性用于容器，而非包裹本身。 (继承自 DtsContainer)
FailParentOnFailure	获得或设置 一个 Boolean ，定义父容器在子容器失败时是否失败。 (继承自 DtsContainer)
ForcedExecutionValue	如果属性 ForceExecutionValue 设置为 True，则会获得或设置一个值，指定包返回的可选执行值。 (继承自 DtsContainer)
ForceExecutionResult	获取或设置一个 DTSForcedExecResult 枚举值，指定容器的强制执行结果。 (继承自 DtsContainer)
ForceExecutionValue	获取或设置一个布尔值，指示容器的执行值是否应强制包含某个特定值。 (继承自 DtsContainer)
HasExpressions	获得一个表示对象是否 ForLoop 具有表达式的值。
ID	返回 的 ID 是一个 GUID。DtsContainer 该值为只读。 (继承自 DtsContainer)
InitExpression	获取或设置可选的初始化表达式。
IsDefaultLocaleID	一个布尔值，表示容器是否使用默认位置。 此属性为只读。 (继承自 DtsContainer)
IsolationLevel	获取或设置对象中 DtsContainer 交易的隔离级别。 (继承自 DtsContainer)
LocaleID	获取或设置一个整数，指示执行对象时DtsContainer使用的 Microsoft Win32® localeID。 (继承自 DtsContainer)
LogEntryInfos	返回 LogEntryInfos 对象。 此属性为只读。 (继承自 DtsContainer)
LoggingMode	从枚举中获取或设置一个有效值 DTSLoggingMode ，指示容器的日志模式。 (继承自 DtsContainer)
LoggingOptions	返回一个包含属性的对象，该属性指示容器的过滤和日志资源。 此属性为只读。 (继承自 DtsContainer)
MaximumErrorCount	获取或设置一个整数值，表示在停止运行前 DtsContainer 可能发生的最大错误次数。 (继承自 DtsContainer)
Name	获取或设置 . 的名称 DtsContainer。 (继承自 DtsContainer)
Parent	返回父容器。 该值为只读。 (继承自 DtsContainer)
PrecedenceConstraints	返回集合 PrecedenceConstraints 。 此字段是只读的。
Properties	返回一组属性 ForLoop ，映射到集合 DtsProperties 中。
Site	获取或设置集装箱的地点。 (继承自 DtsContainer)
StartTime	返回容器开始执行的时间。 此属性为只读。 (继承自 DtsContainer)
StopTime	返回容器执行结束的时间。 此属性为只读。 (继承自 DtsContainer)
SuspendRequired	获得或设置一个布尔值，指示任务在遇到断点时是否应暂停。 当遇到断点时，运行时引擎为任务和容器设置该值。 (继承自 DtsContainer)
TransactionOption	获取或设置一个 DTSTransactionOption 枚举值，指示容器是否参与交易。 (继承自 DtsContainer)
VariableDispenser	返回 VariableDispenser 一个对象，以便锁定与容器相关的变量。 (继承自 DtsContainer)
Variables	返回包含该容器相关变量的集合。 此属性为只读。 (继承自 DtsContainer)

方法

名称	说明
AcceptBreakpointManager(BreakpointManager)	当创建任务或容器时，运行时引擎调用此方法，并传递 BreakpointManager 管理器以允许任务创建、删除和检查断点状态。 该方法由运行时调用，不用于代码中。 (继承自 DtsContainer)
Dispose()	执行与释放、释放或重置非托管资源关联的应用程序定义任务。 (继承自 DtsContainer)
Equals(Object)	确定两个对象实例是否相等。 (继承自 DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	将应用程序、容器或包作为包工作流的一部分运行。 (继承自 DtsContainer)
GetExecutionPath()	获取对象的 ForLoop 执行路径。
GetExpression(String)	返回包含指定属性表达式的字符串。 空意味着没有分配表达式。
GetHashCode()	返回此实例的哈希代码。 (继承自 DtsObject)
GetPackagePath()	返回一个包含包位置相对路径的字符串。
LoadFromXML(XmlNode, IDTSEvents)	你的应用代码无法调用此方法。 要加载保存为 .xml的包裹，请使用以下 LoadPackage(String, IDTSEvents) 方法。 (继承自 DtsContainer)
ResumeExecution()	暂停后继续执行任务。 任务或容器由运行时引擎恢复。 (继承自 DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	你的应用代码无法调用此方法。 要将包保存为 .xml，请使用以下 SaveToXml(String, Package, IDTSEvents) 方法。 (继承自 DtsContainer)
SetExpression(String, String)	将指定的表达式赋予该属性。 指定 null 以从属性中移除已有表达式。
SetWrappedExecutable(IDTSExecutable100)	返回包裹后的可执行对象。 (继承自 EventsProvider)
SuspendExecution()	当可执行文件需要暂停时调用。 该方法由运行时引擎调用。 (继承自 DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	允许容器判断是否包含无效设置，导致无法成功执行。 (继承自 DtsContainer)

活动

名称	说明
Disposed	添加事件处理程序以侦 Disposed 听组件上的事件。 (继承自 DtsContainer)