LogProviderBase.Validate(IDTSInfoEvents) Метод

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Runtime

Сборка:

Microsoft.SqlServer.ManagedDTS.dll

Вызывается для подтверждения правильности настройки регистратора.

public:
 virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);

public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);

abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResult

Параметры

events

IDTSInfoEvents

Интерфейс IDTSInfoEvents, который используется для вызова информационных событий во время выполнения пакета.

Возвращаемое значение

DTSExecResult

Значение из структуры DTSExecResult, которое указывает на успешное или неудачное завершение проверки.

Примеры

В следующем примере кода показано, как проверить объекты с помощью Validate метода Package объекта.

DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);  

Dim myresult As DTSExecResult =  pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)  

Комментарии

Метод Validate проверяет свойства и параметры на наличие неточностей или неправильных параметров. Метод не касается данных или не подключается к источникам данных для проверки подключений. Однако это гарантирует, что обязательные поля заполняются и содержат соответствующие значения. Проверяемые поля различаются в зависимости от проверяемого объекта. Для поставщиков журналов Validate метод проверяет ConfigString правильность настройки свойства, а также все другие свойства или параметры, необходимые поставщику журналов, заданы должным образом. Поставщики журналов, требующие подключения к внешним источникам данных, делают это с помощью ConnectionManager объектов. Свойство ConfigString часто используется для хранения имени или идентификатора ConnectionManager коллекции Connections .

В этом случае убедитесь, Validate что указанный ConnectionManager в свойстве ConfigString свойство существует в пакете.

Если Failure возвращается, выполнение пакета отменяется.

Основное использование заключается в написании Validate пользовательской задачи. Этот Validate метод вызывается конструктором служб SSIS, когда задача удаляется в область конструктора, и, возможно, несколько раз, когда задаются свойства. Однако в коде Validate метод для отдельных объектов обычно не используется, так как рекомендуется вызывать Validate метод в случае Package необходимости проверки объектов. Однако этот метод доступен для отдельных объектов, если он необходим.

Метод Validate переопределяется в пользовательских задачах для проверки объекта при использовании в конструкторе служб SSIS или при вызове по коду. Дополнительные сведения о написании Validate метода для пользовательской задачи см. в разделе "Написание кода пользовательской задачи".