IDTSDesigntimeComponent100.Validate 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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 枚举中的一个指示组件状态的值。
- 属性
注解
Validate 方法由组件开发人员实现,用于验证是否已正确配置组件。 它在包设计期间重复调用,在执行组件之前重复调用一次。 组件不应在验证期间修改其 IDTSComponentMetaData100 。
每个组件对成功验证有不同的要求,但以下列表提供了一些应验证的常见项。
验证组件是否具有预期数量的 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 实现中修复。 当枚举值VS_NEEDSNEWMETADATA时,SSIS 设计器将提示用户组件可以自行修复。 然后,设计器将调用 ReinitializeMetaData 方法。 |
VS_ISCORRUPT | 指示 ComponentMetaData 已损坏,并且无法通过调用 ReinitializeMetaData 方法或编辑组件来修复。 |
DelayValidation当数据流任务的 属性为 true 时,将消除对 Validate 方法的设计时调用,而是在组件执行之前调用 方法。