IDTSDesigntimeComponent100.Validate Метод

Определение

Пространство имен:
Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012
Сборка:
Microsoft.SqlServer.DTSPipelineWrap.dll
public:
 Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2012::DTSValidationStatus Validate();
[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus Validate();
[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus
Public Function Validate () As DTSValidationStatus

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

DTSValidationStatus

Значение из перечисления DTSValidationStatus, указывающее статус компонента.

Атрибуты
DispIdAttribute

Комментарии

Метод Validate реализуется разработчиками компонентов для проверки правильной настройки компонента. Он вызывается многократно при проектировании пакета и один раз перед выполнением компонента. Компоненты не должны изменять IDTSComponentMetaData100 во время проверки.

Каждый компонент имеет свои требования для успешной валидации, но в следующем списке приводятся некоторые общие элементы, которые следует проверить.

  • Проверьте, что компонент имеет ожидаемое количество объектов IDTSInput100 и IDTSOutput100.

  • Проверьте, что любые объекты IDTSCustomProperty100 продолжают существовать и содержат правильные значения.

  • Проверьте, что каждый объект IDTSInputColumn100 в его IDTSInputColumnCollection100 ссылается на существующий объект IDTSOutputColumn100 в входящем компоненте.

  • Если компонент использует соединение, проверьте, что IDTSRuntimeConnection100 указан и что ConnectionManager присутствует в пакете.

Компоненты должны предоставлять пользователям обратную связь при неудаче валидации. Обратная связь предоставляется через методы FireError и FireWarning, а также через возвратное значение DTSValidationStatus. Вызовы методов FireError и FireWarning отображаются в окне списка задач в SQL Server Data Tools (SSDT) и должны давать пользователям рекомендации по поводу сбоя валидации. Из четырёх значений в перечислении DTSValidationStatus только VS_ISVALID указывает на успешную валидацию. Остальные три значения указывают на разные уровни отказа. В следующей таблице описаны значения отказов в перечислении и то, как они интерпретируются SSIS Designer.

Статус Описание
VS_ISBROKEN Указывает на неправильную конфигурацию компонента. Пользователю необходимо внести изменения в ComponentMetaData для решения проблем.
VS_NEEDSNEWMETADATA Указывает, что ошибки валидации могут быть исправлены компонентом в реализации метода ReinitializeMetaData. Конструктор SSIS подсказывает пользователям, что компонент может восстановить себя самостоятельно, когда значение перечисления VS_NEEDSNEWMETADATA. Затем дизайнер вызовет метод ReinitializeMetaData.
VS_ISCORRUPT Указывает, что ComponentMetaData повреждены и не могут быть восстановлены вызовом метода ReinitializeMetaData или правками компонента.

Когда свойство DelayValidation задачи потока данных верно, вызовы метода Validate во время проектирования убираются, и метод вызывается перед выполнением компонента.

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