IDTSDesigntimeComponent100.Validate Метод

Определение

Пространство имен:
Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014
Сборка:
Microsoft.SqlServer.DTSPipelineWrap.dll
public:
 Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2014::DTSValidationStatus Validate();
[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatus Validate();
[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.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 во время проектирования убираются, и метод вызывается перед выполнением компонента.

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