IDTSDesigntimeComponent100.Validate Метод

Определение

Пространство имен:
Microsoft.SqlServer.Dts.Pipeline.Wrapper
Сборка:
Microsoft.SqlServer.DTSPipelineWrap.dll

Проверяет, правильно ли настроен компонент.

public:
 Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();
[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate();
[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
Public Function Validate () As DTSValidationStatus

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

DTSValidationStatus

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

Атрибуты
DispIdAttribute

Комментарии

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

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

  • Проверьте, что компонент имеет ожидаемое количество объектов 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 свойство задачи потока данных — true, вызовы Validate метода во время проектирования устраняются, и метод вызывается перед выполнением компонента.

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