ForEachLoop Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет контейнер, который определяет итеративный рабочий процесс в пакете с помощью оператора итерации foreach.
public ref class ForEachLoop 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 ForEachLoop : 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 ForEachLoop = class
inherit EventsProvider
interface IDTSSequence
interface IDTSPropertiesProvider
interface IDTSPropertiesProviderEx
interface IDTSPackagePath
interface IDTSExecutionPath
Public NotInheritable Class ForEachLoop
Inherits EventsProvider
Implements IDTSExecutionPath, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx, IDTSSequence
- Наследование
- Реализации
Комментарии
Во время работы управляющий поток в ForEachLoop контейнере повторяется в рамках общего управляющего потока упаковки.
Поля
| Имя | Описание |
|---|---|
| m_executable |
Исполняемый файл. (Унаследовано от Executable) |
Свойства
| Имя | Описание |
|---|---|
| CreationName |
Возвращает строку, используемую для создания экземпляра объекта DtsContainer . Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| DebugMode |
Получает или устанавливает булевое изображение, которое показывает, находится DtsContainer ли объект в режиме отладки и следует ли запускать OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) событие во время запуска. (Унаследовано от DtsContainer) |
| DelayValidation |
Получает или устанавливает булевое значение, указывающее, задерживается ли валидация задачи до времени выполнения. По умолчанию используется значение false. (Унаследовано от DtsContainer) |
| Description |
Получает или задаёт описание DtsContainer объекта. (Унаследовано от DtsContainer) |
| Disable |
Булевое значение, указывающее на отключение DtsContainer объекта. (Унаследовано от DtsContainer) |
| DisableEventHandlers |
Получает или устанавливает булевое значение, которое показывает, отключены ли обработчики событий в задаче. (Унаследовано от EventsProvider) |
| EventHandlers |
Возвращает коллекцию объектов обработчика событий. Это поле доступно только для чтения. (Унаследовано от EventsProvider) |
| EventInfos |
Возвращает коллекцию EventInfo объектов. Это поле доступно только для чтения. (Унаследовано от EventsProvider) |
| Executables |
Возвращает коллекцию Executable объектов, обработанных движком выполнения преобразования данных во время выполнения ForEachLoop. Это поле доступно только для чтения. |
| ExecutionDuration |
Возвращает значение, показывающее время, проведённое контейнером на выполнение, в миллисекундах. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| ExecutionResult |
Возвращает значение, указывающее на успех или неудачу выполнения DtsContainer объекта. (Унаследовано от DtsContainer) |
| ExecutionStatus |
Возвращает значение, указывающее текущее состояние выполнения DtsContainer объекта на момент вызова. (Унаследовано от DtsContainer) |
| FailPackageOnFailure |
Получает или устанавливает булевое измерение, которое указывает, выходит ли пакет из строя при неудаче дочернего контейнера. Это свойство используется на контейнерах, а не на самой упаковке. (Унаследовано от DtsContainer) |
| FailParentOnFailure |
Получает или задаёт , |
| ForcedExecutionValue |
Если свойство ForceExecutionValue установлено в True, получает или задаёт значение, указывающее необязательное значение выполнения, возвращаемое пакетом. (Унаследовано от DtsContainer) |
| ForceExecutionResult |
Получает или устанавливает DTSForcedExecResult значение перечисления, указывающее результат принудительного выполнения контейнера. (Унаследовано от DtsContainer) |
| ForceExecutionValue |
Получает или задаёт булевое значение, указывающее, должно ли значение исполнения контейнера содержать определённое значение. (Унаследовано от DtsContainer) |
| ForEachEnumerator |
Получает или устанавливает хоста для ForEachEnumerator. |
| HasExpressions |
Получает значение, указывающее, есть ли у ForEachLoop объекта выражения. |
| ID |
Возвращает идентификатор, который является GUID, для DtsContainer. Значение доступно только для чтения. (Унаследовано от DtsContainer) |
| IsDefaultLocaleID |
Булевое изображение, указывающее, использует ли контейнер стандартное местоназначение. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| IsolationLevel |
Получает или устанавливает уровень изоляции транзакции в объекте DtsContainer . (Унаследовано от DtsContainer) |
| LocaleID |
Получает или устанавливает целое число, указывающее локальный идентификатор Microsoft Win32® для использования при выполнении DtsContainer объекта. (Унаследовано от DtsContainer) |
| LogEntryInfos |
Возвращает объект LogEntryInfos. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| LoggingMode |
Получает или устанавливает действительное значение из DTSLoggingMode перечисления, указывающее на режим ведения журнала контейнера. (Унаследовано от DtsContainer) |
| LoggingOptions |
Возвращает объект, содержащий свойства, указывающие ресурс фильтрации и логирования контейнеров. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| MaximumErrorCount |
Получает или устанавливает целочисленное значение, указывающее максимальное количество ошибок, которые могут возникнуть до прекращения работы DtsContainer объекта. (Унаследовано от DtsContainer) |
| Name |
Возвращает или задает имя DtsContainerобъекта . (Унаследовано от DtsContainer) |
| Parent |
Возвращает родительский контейнер. Значение доступно только для чтения. (Унаследовано от DtsContainer) |
| PrecedenceConstraints |
Возвращает PrecedenceConstraints коллекцию, содержащую все ограничения приоритета, связанные с ForEachLoop. |
| Properties |
Возвращает коллекцию DtsProperty объектов, связанных с ForEachLoop. |
| Site |
Получает или устанавливает сайт для контейнера. (Унаследовано от DtsContainer) |
| StartTime |
Возвращает время начала выполнения контейнера. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| StopTime |
Возвращает время, когда контейнер завершил выполнение. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
| SuspendRequired |
Получает или устанавливает булевый индикатор, который показывает, должны ли задачи приостановиться при возникновении точки остановки. Это значение задаётся движком выполнения для задач и контейнеров при обнаружении точки остановки. (Унаследовано от DtsContainer) |
| TransactionOption |
Получает или устанавливает DTSTransactionOption перечислительное значение, указывающее, участвует ли контейнер в транзакциях. (Унаследовано от DtsContainer) |
| VariableDispenser |
Возвращает VariableDispenser объект, чтобы переменные, связанные с контейнером, могли быть заблокированы. (Унаследовано от DtsContainer) |
| VariableMappings |
Возвращает ForEachVariableMappings коллекцию, содержащую отображения переменных для ForEachLoop. |
| Variables |
Возвращает коллекцию, содержащую переменные, связанные с этим контейнером. Это свойство доступно только для чтения. (Унаследовано от DtsContainer) |
Методы
| Имя | Описание |
|---|---|
| AcceptBreakpointManager(BreakpointManager) |
Этот метод вызывается движком выполнения при создании задачи или контейнера и передаёт ей BreakpointManager менеджер, позволяющий задаче создавать, удалять и проверять состояние точек остановки. Этот метод вызывается в среде выполнения и не используется в коде. (Унаследовано от DtsContainer) |
| Dispose() |
Выполняет определяемые приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов. (Унаследовано от DtsContainer) |
| Equals(Object) |
Определяет, равны ли два экземпляра объекта. (Унаследовано от DtsObject) |
| Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object) |
Запускает приложение, контейнер или пакет как часть рабочего процесса пакета. (Унаследовано от DtsContainer) |
| GetExecutionPath() |
Получает путь выполнения объекта ForEachLoop . |
| GetExpression(String) |
Возвращает строку, содержащую выражение для указанного свойства. Null означает, что выражение не присваивается. |
| 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) |