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 对象是否继续存在并包含正确的值。

• 验证其IDTSInputColumnCollection100中的每个IDTSInputColumn100对象是否引用上游组件中的现有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 ，并在组件执行之前调用该方法。