Поделиться через


Package Класс

Определение

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

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
Наследование
Реализации

Комментарии

Пакет представляет собой коллекцию других контейнеров, подключений, задач, преобразований, переменных, конфигураций и ограничений приоритета. Пакеты можно создавать программным способом или с помощью графического средства конструктора служб 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)

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