PipelineComponent.Validate 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重要
此 API 不符合 CLS。
验证该组件已正确配置。
public:
virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Overridable Function Validate () As DTSValidationStatus返回
来自 DTSValidationStatus 枚举中的一个指示组件状态的值。
- 属性
注解
组件开发人员会重写该方法 Validate ，以验证是否已正确配置该组件。 它在包设计期间反复调用，并在组件执行前一次调用。 组件不应在 ComponentMetaData .Validate
检查其属性与IDTSOutputColumn100LineageID上游组件不匹配的对象LineageID是否存在的IDTSInputColumn100基类实现Validate。 组件开发人员应通过对ComponentMetaData基类功能执行其他检查来扩展基类Validate功能。 每个组件对成功验证有不同的要求，但以下列表提供了应验证的一些常见项。
验证组件是否具有预期的数量 IDTSInput100 和 IDTSOutput100 对象。
验证是否存在任何 IDTSCustomProperty100 对象，并包含正确的值。
如果组件使用连接，它应验证 IDTSRuntimeConnection100 是否已指定且 ConnectionManager 包中是否存在。
当验证失败时，组件应向用户提供反馈。 反馈通过 FireError 方法 FireWarning 以及 DTSValidationStatus 返回值提供。 SQL Server Data Tools (SSDT) 中的“错误列表”窗口中显示调用FireError并FireWarning显示在“错误列表”窗口中，并应提供有关验证失败的用户指南。 在枚举中的四个值中 DTSValidationStatus ，仅 VS_ISVALID 指示成功验证。 其他三个值表示不同级别的故障。 下表描述了枚举中的失败值以及 SSIS 设计器如何解释这些值。
| 状态 | 说明 |
|---|---|
| VS_ISBROKEN | 指示组件未正确配置，但用户对 ComponentMetaData 组件的更改将解决问题。 |
| VS_NEEDSNEWMETADATA | 指示验证错误可由组件在其方法的实现 ReinitializeMetaData 中修复。 SSIS 设计器将提示用户在调用组件后VS_NEEDSNEWMETADATA可以自行修复。ReinitializeMetaData |
| VS_ISCORRUPT | 指示已损坏， ComponentMetaData 无法通过调用 ReinitializeMetaData 或编辑组件进行修复。 |
当 DelayValidation 数据流任务的属性为 true时，将消除对 Validate 的设计时间调用，并在组件执行之前调用该方法。
有关详细信息，请参阅验证数据流组件。