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 — при написании индивидуальной задачи. Метод вызывается дизайнером SSIS, когда задача попадает на поверхность проектирования, а также снова, возможно несколько раз, когда устанавливаются Validate свойства. Однако в коде метод Validate для отдельных объектов используется редко, так как рекомендуется вызывать его Validate при Package проверке объектов. Однако метод доступен на отдельных объектах, если вы найдёте уникальную ситуацию, где он необходим.

Метод Validate переопределяется в пользовательских задачах — либо для проверки объекта при использовании в SSIS Designer, либо при вызове кодом. Для получения дополнительной информации о написании Validate метода для пользовательской задачи см. раздел Кодирование пользовательской задачи.