Поделиться через

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.

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

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

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