ForEachLoopClass 類別

定義

提供一個容器,該容器會使用 foreach 反覆運算語句來定義封裝中的反復式工作流程。

public ref class ForEachLoopClass : Microsoft::SqlServer::Dts::Runtime::Wrapper::ForEachLoop, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSBreakpointSite100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSContainer100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSEventsProvider100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSExecutionMetrics100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSForEachLoop100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSName100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSPersist100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSPropertiesProvider100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSRuntimeObject100, Microsoft::SqlServer::Dts::Runtime::Wrapper::IDTSSequence100
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.Guid("C2DA94B4-782A-4F02-8532-B79F2F17EF2C")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FCanCreate)]
public class ForEachLoopClass : Microsoft.SqlServer.Dts.Runtime.Wrapper.ForEachLoop, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSBreakpointSite100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSContainer100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSEventsProvider100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSExecutionMetrics100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSForEachLoop100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSName100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSPersist100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSPropertiesProvider100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSRuntimeObject100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSSequence100
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FCanCreate)]
[System.Runtime.InteropServices.Guid("8D9B72A5-CF6C-43F6-810D-BA54BE7CDF5A")]
public class ForEachLoopClass : Microsoft.SqlServer.Dts.Runtime.Wrapper.ForEachLoop, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSBreakpointSite100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSContainer100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSEventsProvider100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSExecutionMetrics100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSForEachLoop100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSName100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSPersist100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSPropertiesProvider100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSRuntimeObject100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSSequence100
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FCanCreate)]
[System.Runtime.InteropServices.Guid("B4239650-285C-4F45-8F7B-759C3009A565")]
public class ForEachLoopClass : Microsoft.SqlServer.Dts.Runtime.Wrapper.ForEachLoop, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSBreakpointSite100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSContainer100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSEventsProvider100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSExecutionMetrics100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSForEachLoop100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSName100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSPersist100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSPropertiesProvider100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSRuntimeObject100, Microsoft.SqlServer.Dts.Runtime.Wrapper.IDTSSequence100
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.Guid("C2DA94B4-782A-4F02-8532-B79F2F17EF2C")>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FCanCreate)>]
type ForEachLoopClass = class
    interface IDTSExecutable100
    interface ForEachLoop
    interface IDTSForEachLoop100
    interface IDTSContainer100
    interface IDTSSequence100
    interface IDTSEventsProvider100
    interface IDTSExecutionMetrics100
    interface IDTSPropertiesProvider100
    interface IDTSBreakpointSite100
    interface IDTSSuspend100
    interface IDTSPersist100
    interface IDTSRuntimeObject100
    interface IDTSName100
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FCanCreate)>]
[<System.Runtime.InteropServices.Guid("8D9B72A5-CF6C-43F6-810D-BA54BE7CDF5A")>]
type ForEachLoopClass = class
    interface IDTSExecutable100
    interface ForEachLoop
    interface IDTSForEachLoop100
    interface IDTSContainer100
    interface IDTSSequence100
    interface IDTSEventsProvider100
    interface IDTSExecutionMetrics100
    interface IDTSPropertiesProvider100
    interface IDTSBreakpointSite100
    interface IDTSSuspend100
    interface IDTSPersist100
    interface IDTSRuntimeObject100
    interface IDTSName100
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FCanCreate)>]
[<System.Runtime.InteropServices.Guid("B4239650-285C-4F45-8F7B-759C3009A565")>]
type ForEachLoopClass = class
    interface IDTSExecutable100
    interface ForEachLoop
    interface IDTSForEachLoop100
    interface IDTSContainer100
    interface IDTSSequence100
    interface IDTSEventsProvider100
    interface IDTSExecutionMetrics100
    interface IDTSPropertiesProvider100
    interface IDTSBreakpointSite100
    interface IDTSSuspend100
    interface IDTSPersist100
    interface IDTSRuntimeObject100
    interface IDTSName100
Public Class ForEachLoopClass
Implements ForEachLoop, IDTSBreakpointSite100, IDTSContainer100, IDTSEventsProvider100, IDTSExecutionMetrics100, IDTSForEachLoop100, IDTSName100, IDTSPersist100, IDTSPropertiesProvider100, IDTSRuntimeObject100, IDTSSequence100
繼承
ForEachLoopClass
屬性
實作

建構函式

ForEachLoopClass()

初始化 ForEachLoopClass 類別的新執行個體。

屬性

CreationName

傳回用來建立 ForEachLoopClass 物件執行個體的字串。 這是唯讀的屬性。

DebugMode

取得或設定布林值,這個布林值會指出物件是否處於「偵測」 ForEachLoopClass 模式,以及它是否應該在執行 OnBreakpointHit(IDTSBreakpointSite100, IDTSBreakpointTarget100) 時引發事件。

DelayValidation

取得或設定布林值,這個布林值表示是否要延遲到執行時間才驗證工作。 預設值為 false。

Description

取得或設定 ForEachLoopClass 物件的描述。

Disable

取得布林值,指出物件是否 ForEachLoopClass 已停用。

DisableEventHandlers

取得布林值,這個布林值表示是否停用工作上的事件處理常式。

EventHandlers

取得事件處理常式物件的集合。 此欄位為唯讀。

EventInfos

取得 IDTSEventInfo100 物件的集合。 此欄位為唯讀。

Executables

取得可執行物件的集合。

ExecutionDuration

傳回值,這個值表示容器花在執行的時間量 (以毫秒為單位)。 這是唯讀的屬性。

ExecutionResult

傳回值,指出 ForEachLoopClass 物件執行成功或失敗。

ExecutionStatus

傳回值,這個值表示 ForEachLoopClass 物件在呼叫時的目前執行狀態。

FailPackageOnFailure

取得或設定布林值,指出子容器失敗時,封裝是否失敗。

FailParentOnFailure

取得或設定布林值,這個布林值會定義當子容器失敗時,父容器是否失敗。

ForcedExecutionValue

如果 ForceExecutionValue 屬性設定為 true,則取得或設定值,這個值會指定封裝所傳回的選擇性執行值。

ForceExecutionResult

取得或設定指定容器強制執行結果的 DTSExecResult 列舉值。

ForceExecutionValue

取得或設定布林值,這個布林值會指出是否應該強制執行容器的執行值以包含特定的值。

ForEachEnumerator

取得或設定 IDTSForEachEnumerator100 的主機。

ID

取得 ForEachLoopClass 的 GUID。 此值是唯讀的。

IDTSSuspend100_SuspendRequired

取得或設定布林值,這個布林值表示當工作遇到中斷點時是否應該暫停。 此值是由執行階段引擎針對工作和容器遇到中斷點時設定的。

IsDefaultLocaleID

布林值,指出容器是否使用預設的地區設定。 這是唯讀的屬性。

IsolationLevel

取得或設定 ForEachLoopClass 物件中的交易隔離等級。

LocaleID

取得或設定整數,這個整數表示執行物件時要使用的 Microsoft Win32® localeID ForEachLoopClass

LogEntryInfos

取得容器的 IDTSLogEntryInfos100 物件。 這個屬性是唯讀的。

LoggingMode

取得或設定 DTSLoggingMode 列舉中的有效值,這個值表示容器的記錄模式。

LoggingOptions

取得物件,該物件包含表示容器之篩選和記錄資源的屬性。 這是唯讀的屬性。

MaximumErrorCount

取得或設定整數值,這個值會指出物件停止執行之前,可以發生的錯誤數目上限 ForEachLoopClass

Name

取得或設定 ForEachLoopClass 的名稱。

Parent

取得父容器。 此值是唯讀的。

PrecedenceConstraints

取得 IDTSPrecedenceConstraints100 集合,其中包含所有與 ForEachLoop 相關聯的優先順序條件約束。

Properties

傳回與 IDTSProperty100 相關聯的 ForEachLoop 物件集合。

StartTime

取得容器開始執行的時間。 這是唯讀的屬性。

StopTime

取得容器結束執行的時間。 這是唯讀的屬性。

SuspendRequired

取得或設定布林值,這個布林值表示當工作遇到中斷點時是否應該暫停。 此值是由執行階段引擎針對工作和容器遇到中斷點時設定的。

TransactionOption

取得或設定 DTSTransactionOption 列舉值,指出容器是否參與交易。

VariableDispenser

取得 IDTSVariableDispenser100 物件,以便可以鎖定與容器相關聯的變數。

VariableMappings

取得 IDTSForEachVariableMappings100 集合,其中包含 ForEachLoop 的變數對應。

Variables

傳回集合,其中包含與這個容器相關聯的變數。 這是唯讀的屬性。

方法

AcceptBreakpointManager(IDTSBreakpointManager100)

接受 IDTSBreakpointManager100 管理員,在建立工作或容器時,由執行階段引擎呼叫此管理員,以便讓工作建立、移除及檢查中斷點的狀態。 這個方法由執行階段呼叫,並不使用於程式碼中。

ComputeExpressions(Boolean)

計算屬性集合中的運算式。

Execute(IDTSConnections100, IDTSVariables100, IDTSEvents100, IDTSLogging100, Object)

執行可執行檔。

GetExpression(String)

傳回字串,其中包含指定之屬性的運算式。 Null 表示未指派任何運算式。

GetParentID()

取得父容器的識別碼。

IDTSForEachLoop100_Execute(IDTSConnections100, IDTSVariables100, IDTSEvents100, IDTSLogging100, Object)

執行可執行檔。

IDTSForEachLoop100_Validate(IDTSConnections100, IDTSVariables100, IDTSEvents100, IDTSLogging100)

透過在執行之前先驗證所有相依性和其他項目的方式,確認可執行檔將成功執行。

IDTSSuspend100_get_SuspendRequired()
IDTSSuspend100_ResumeExecution()

在暫停之後繼續執行工作。 工作或容器是由執行階段引擎繼續執行。

IDTSSuspend100_set_SuspendRequired(Boolean)
IDTSSuspend100_SuspendExecution()

表示可執行檔必須暫停。 執行階段引擎會呼叫這個方法。

LoadFromXML(Object, IDTSEvents100)

載入以 XML 格式儲存的資料。

RegenerateID()

如需詳細資訊,請參閱ForEachLoop

ResumeExecution()

在暫停之後繼續執行工作。 工作或容器是由執行階段引擎繼續執行。

SaveToXML(Object, Object, IDTSEvents100)

將資訊儲存到 XML 文件。

SetExpression(String, String)

將指定的運算式指派至屬性。 指定 null 可從屬性中移除現有的運算式。

SuspendExecution()

表示可執行檔必須暫停。 執行階段引擎會呼叫這個方法。

Validate(IDTSConnections100, IDTSVariables100, IDTSEvents100, IDTSLogging100)

透過在執行之前先驗證所有相依性和其他項目的方式,確認可執行檔將成功執行。

適用於