Package Класс

Ссылка

Определение

Пространство имен:: Microsoft.SqlServer.Dts.Runtime

Сборка:: Microsoft.SqlServer.ManagedDTS.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет контейнер пакета. Этот класс не наследуется.

public ref class Package sealed : Microsoft::SqlServer::Dts::Runtime::EventsProvider, Microsoft::SqlServer::Dts::Runtime::IDTSConfigurationControl, 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 Package : Microsoft.SqlServer.Dts.Runtime.EventsProvider, Microsoft.SqlServer.Dts.Runtime.IDTSConfigurationControl, 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 Package = class
    inherit EventsProvider
    interface IDTSSequence
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath
    interface IDTSConfigurationControl

Public NotInheritable Class Package
Inherits EventsProvider
Implements IDTSConfigurationControl, IDTSExecutionPath, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx, IDTSSequence

Наследование: Object

DtsObject

Executable

DtsContainer

EventsProvider
Package

Реализации: IDTSConfigurationControl IDTSExecutionPath IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx IDTSSequence

Пакет представляет собой коллекцию других контейнеров, подключений, задач, преобразований, переменных, конфигураций и ограничений приоритета. Пакеты можно создавать программным способом или с помощью графического средства конструктора служб SSIS. Пакеты можно сохранять в различных расположениях, включая Microsoft SQL Server или XML-файл.

Дополнительные сведения о пакетах см. в статьях о пакетах служб Integration Services (SSIS).

Конструкторы

Package()

Инициализирует новый экземпляр класса Package.

Поля

m_executable

Исполняемый объект.

(Унаследовано от Executable)

Свойства

CertificateContext	Возвращает или задает объект сертификата X.509 для пакета.
CertificateObject	Возвращает или задает объект сертификата X.509 для пакета.
CheckpointFileName	Возвращает или задает имя файла для записи сведений о контрольных точках, которые позволяют перезапускать пакет.
CheckpointUsage	Возвращает или задает значение, указывающее, перезапускается ли пакет и когда это происходит.
CheckSignatureOnLoad	Возвращает или задает значение, указывающее, проверяется ли цифровая подпись при загрузке пакета.
Configurations	Возвращает коллекцию конфигураций для пакета. С пакетом может быть связана одна или несколько конфигураций. Это свойство доступно только для чтения.
Connections	Возвращает коллекцию диспетчеров соединений для пакета.
CreationDate	Возвращает или задает дату и время создания пакета.
CreationName	Возвращает строку, используемую для создания экземпляра объекта DtsContainer. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
CreatorComputerName	Возвращает или задает имя компьютера, на котором был создан пакет.
CreatorName	Возвращает или задает имя лица, создавшего этот пакет.
DebugMode	Возвращает или задает логическое значение, указывающее, находится ли DtsContainer объект в режиме отладки и должен ли он запускать OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) событие во время выполнения. (Унаследовано от DtsContainer)
DelayValidation	Возвращает или задает логическое значение, указывающее, задерживается ли проверка задачи до времени выполнения. Значение по умолчанию — false. (Унаследовано от DtsContainer)
Description	Возвращает или задает описание объекта DtsContainer. (Унаследовано от DtsContainer)
DesignEvents	Возвращает или задает объект IDTSEvents, указывающий, будет ли конструктор или другой сторонний клиент получать события во время разработки.
DesignTimeProperties	Возвращает или задает свойства времени дизайна пакета, такие как сведения о макетах.
Disable	Логическое значение, указывающее, отключен ли DtsContainer объект. (Унаследовано от DtsContainer)
DisableEventHandlers	Возвращает или задает логическое значение, указывающее, отключены ли обработчики событий в задаче. (Унаследовано от EventsProvider)
DumpDescriptor	Указывает, когда должен быть создан файл дампа.
DumpOnAnyError	Указывает, следует ли создавать файл дампа, если во время выполнения пакета возникают ошибки.
EnableConfigurations	Возвращает или задает значение, указывающее, загружает ли пакет конфигурации.
EnableDump	Указывает, включено ли формирование файла дампа.
EncryptCheckpoints	Возвращает или задает значение, указывающее, шифруются ли файлы контрольных точек.
Errors	Возвращает коллекцию ошибок, связанных с пакетом. Это поле доступно только для чтения.
EventHandlers	Возвращает коллекцию объектов обработчика события. Это поле доступно только для чтения. (Унаследовано от EventsProvider)
EventInfos	Возвращает коллекцию объектов EventInfo. Это поле доступно только для чтения. (Унаследовано от EventsProvider)
Executables	Возвращает коллекцию исполняемых объектов, содержащихся в пакете, которые являются частью рабочего процесса пакета.
ExecutionDuration	Возвращает значение, указывающее время, затраченное контейнером на выполнение (в миллисекундах). Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
ExecutionResult	Возвращает значение, указывающее на успешное или неуспешное выполнение объекта DtsContainer. (Унаследовано от DtsContainer)
ExecutionStatus	Возвращает значение, указывающее текущее состояние выполнения объекта DtsContainer во время вызова. (Унаследовано от DtsContainer)
ExtendedProperties	Возвращает коллекцию ExtendedProperties для пакета.
FailPackageOnFailure	Возвращает или задает значение, указывающее, завершается ли выполнение пакета сбоем при сбое в задаче или в компоненте в пакете.
FailParentOnFailure	Возвращает или задает значение типа `Boolean`, определяющее, завершается ли работа родительского контейнера с ошибкой в случае ошибки в дочернем контейнере. (Унаследовано от DtsContainer)
ForcedExecutionValue	ForceExecutionValue Если свойству присвоено значение True, возвращает или задает значение, указывающее необязательное значение выполнения, возвращаемое пакетом. (Унаследовано от DtsContainer)
ForceExecutionResult	Возвращает или задает значение перечисления DTSForcedExecResult, указывающее результат принудительного выполнения контейнера. (Унаследовано от DtsContainer)
ForceExecutionValue	Возвращает или задает логическое значение, указывающее, должно ли принудительное выполнение контейнера содержать определенное значение. (Унаследовано от DtsContainer)
HasExpressions	Возвращает значение, указывающее, содержит ли пакет выражения.
ID	Возвращает идентификатор, который представляет собой идентификатор GUID, для DtsContainer. Это значение доступно только для чтения. (Унаследовано от DtsContainer)
IgnoreConfigurationsOnLoad	Возвращает или задает значение, указывающее, пропускает ли пакет конфигурации во время загрузки пакета.
InteractiveMode	Возвращает или задает значение, указывающее, должны ли задачи показывать объекты пользовательского интерфейса во время выполнения.
IsDefaultLocaleID	Логическое значение, указывающее, использует ли контейнер языковой стандарт по умолчанию. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
IsolationLevel	Возвращает или задает уровень изоляции транзакции в объекте DtsContainer. (Унаследовано от DtsContainer)
LocaleID	Возвращает или задает целое число, указывающее языковой стандарт Microsoft Win32®, используемый при DtsContainer выполнении объекта. (Унаследовано от DtsContainer)
LogEntryInfos	Возвращает объект LogEntryInfos. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
LoggingMode	Возвращает или задает допустимое значение из перечисления DTSLoggingMode, указывающее режим ведения журнала контейнера. (Унаследовано от DtsContainer)
LoggingOptions	Возвращает объект, который содержит свойства, указывающие ресурсы фильтрации и ведения журналов для контейнеров. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
LogProviders	Возвращает коллекцию регистраторов, связанных с пакетом.
MaxConcurrentExecutables	Возвращает или задает число потоков, которые может создать пакет.
MaximumErrorCount	Возвращает или задает целочисленное значение, указывающее максимальное количество ошибок, которые могут возникнуть до остановки DtsContainer выполнения объекта. (Унаследовано от DtsContainer)
Name	Возвращает или задает имя таблицы для объекта DtsContainer. (Унаследовано от DtsContainer)
OfflineMode	Возвращает или задает значение, указывающее, работает ли пакет в режиме «вне сети».
PackagePassword	Задает значение пароля для пакета. Это свойство доступно только на запись.
PackagePriorityClass	Указывает класс приоритета потока пакета в системе Win32.
PackageType	Указывает значение, определяющее средство, с помощью которого был создан пакет.
PackageUpgradeOptions	Возвращает или задает параметр обновления пакета.
Parameters	Возвращает коллекцию параметров для пакета.
Parent	Возвращает родительский контейнер. Это значение доступно только для чтения. (Унаследовано от DtsContainer)
PrecedenceConstraints	Возвращает коллекцию объектов PrecedenceConstraint. Это поле доступно только для чтения.
Project	Возвращает или задает указанный проект, связанный с пакетом.
Properties	Возвращает коллекцию объектов DtsProperties для пакета.
ProtectionLevel	Возвращает уровень защиты пакета.
SafeRecursiveProjectPackageExecution	Возвращает или задает значение, указывающее, является ли рекурсивное выполнение пакета безопасным.
SaveCheckpoints	Возвращает или задает значение, указывающее, будет ли пакет использовать контрольные точки во время выполнения.
Site	Возвращает или задает сайт для контейнера. (Унаследовано от DtsContainer)
StartTime	Возвращает время начала выполнения контейнером. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
StopTime	Возвращает время завершения выполнения контейнером. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
SuppressConfigurationWarnings	Возвращает или задает значение, указывающее, подавляются ли предупреждения, формируемые конфигурациями.
SuspendRequired	Возвращает или задает логическое значение, указывающее, должны ли задачи приостанавливаться при обнаружении точки останова. Это значение устанавливается подсистемой среды выполнения для задач и контейнеров при обнаружении точки останова. (Унаследовано от DtsContainer)
TransactionOption	Возвращает или задает значение перечисления DTSTransactionOption, указывающее, участвует ли контейнер в транзакциях. (Унаследовано от DtsContainer)
UpdateObjects	* Элемент устарел; см. примечания. * Возвращает или задает значение, указывающее, можно ли обновить расширяемые объекты во время загрузки пакета в случае обнаружения обновленной версии.
VariableDispenser	Возвращает объект VariableDispenser, чтобы можно было блокировать переменные, связанные с контейнером. (Унаследовано от DtsContainer)
Variables	Возвращает коллекцию, содержащую переменные, связанные с контейнером. Это свойство доступно только для чтения. (Унаследовано от DtsContainer)
VersionBuild	Возвращает версию сборки пакета.
VersionComments	Возвращает комментарии к версии, связанные с пакетом.
VersionGUID	Возвращает идентификатор GUID версии, сформированный при создании пакета. Это поле доступно только для чтения.
VersionMajor	Возвращает основную версию сборки пакета.
VersionMinor	Возвращает дополнительную версию сборки пакета.
Warnings	Возвращает коллекцию предупреждений, назначенных для пакета. Это поле доступно только для чтения.

Методы

AcceptBreakpointManager(BreakpointManager)	Этот метод вызывается средой выполнения при создании задачи или контейнера и передает им диспетчер BreakpointManager, чтобы обеспечить для задачи возможность создания, удаления и проверки состояния точек останова. Этот метод вызывается средой выполнения и не используется в коде. (Унаследовано от DtsContainer)
AddDataTapPoint(String, String, Int32, String)	Добавьте точку касания данных в заданный поток данных и заданный путь к потоку данных.
CheckSignature()	Проверяет состояние цифровой подписи пакета.
ComputeExpressions(Boolean)	Вычисляет выражения объекта пакета.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от DtsContainer)
Equals(Object)	Определяет, равны ли два экземпляра объекта. (Унаследовано от DtsObject)
Execute()	Возвращает перечисление DTSExecResult, которое содержит данные об успешном или неуспешном выполнении пакета.
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Выполняет приложение, контейнер или пакет в рамках рабочего процесса пакетов. (Унаследовано от DtsContainer)
ExportConfigurationFile(String)	Создает XML-файл, содержащий все развертываемые переменные в пакете.
FindReferencedObjects(Object)	Возвращает перечисление объекта ссылки.
GetBreakpointTargets(IDTSBreakpointSite, Boolean)	Возвращает коллекцию BreakpointTargets. В зависимости от настройки параметра `onlyEnabled` коллекция содержит все целевые объекты точек останова в пакете или только включенные целевые объекты точек останова.
GetExecutionPath()	Возвращает путь выполнения текущего пакета.
GetExpression(String)	Возвращает значение, содержащее выражение для указанного свойства. Значение NULL означает, что выражение не назначено.
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от DtsObject)
GetObjectFromPackagePath(String, DtsProperty)	Возвращает свойство пакета и объект из указанного пути пакета.
GetPackagePath()	Возвращает значение, которое содержит относительный путь к местоположению пакета.
ImportConfigurationFile(String)	Загружает файл конфигурации, связанный с пакетом.
LoadFromXML(String, IDTSEvents)	Загружает пакет и все его объекты, сохраненные в памяти в XML-формате. Чтобы загрузить пакет, сохраненный на жестком диске, вызовите метод LoadPackage(String, IDTSEvents).
LoadFromXML(XmlNode, IDTSEvents)	Вызов этого метода кодом вашего приложения невозможен. Для загрузки пакета, сохраненного в виде XML-файла, используйте метод LoadPackage(String, IDTSEvents). (Унаследовано от DtsContainer)
LoadUserCertificateByHash(Byte[])	Загружает сертификат для пакета в соответствии с хэшем сертификата.
LoadUserCertificateByName(String)	Загружает сертификат для пакета в соответствии с именем сертификата.
ProcessConfiguration(String, Object)	Задает сведения о конфигурации для пакета и его объектов.
RegenerateID()	Создает новый идентификатор GUID для пакета и обновляет свойство идентификатора пакета.
ResumeExecution()	Возобновляет выполнение задачи после приостановки. Задача или контейнер возобновляются средой выполнения. (Унаследовано от DtsContainer)
SaveToXML(String, IDTSEvents)	Сохраняет пакет в памяти в XML-формате. Сохранение пакета в виде XML-файла на жестком диске производится методом SaveToXml(String, Package, IDTSEvents).
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)

Применяется к