PipelineComponent.Validate 方法

定义

重要

此 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.DTSValidationStatus
Public Overridable Function Validate () As DTSValidationStatus

返回

来自 DTSValidationStatus 枚举中的一个指示组件状态的值。

属性

注解

组件开发人员会重写该方法 Validate ,以验证是否已正确配置该组件。 它在包设计期间反复调用,并在组件执行前一次调用。 组件不应在 ComponentMetaData .Validate

检查其属性与IDTSOutputColumn100LineageID上游组件不匹配的对象LineageID是否存在的IDTSInputColumn100基类实现Validate。 组件开发人员应通过对ComponentMetaData基类功能执行其他检查来扩展基类Validate功能。 每个组件对成功验证有不同的要求,但以下列表提供了应验证的一些常见项。

当验证失败时,组件应向用户提供反馈。 反馈通过 FireError 方法 FireWarning 以及 DTSValidationStatus 返回值提供。 SQL Server Data Tools (SSDT) 中的“错误列表”窗口中显示调用FireErrorFireWarning显示在“错误列表”窗口中,并应提供有关验证失败的用户指南。 在枚举中的四个值中 DTSValidationStatus ,仅 VS_ISVALID 指示成功验证。 其他三个值表示不同级别的故障。 下表描述了枚举中的失败值以及 SSIS 设计器如何解释这些值。

状态 说明
VS_ISBROKEN 指示组件未正确配置,但用户对 ComponentMetaData 组件的更改将解决问题。
VS_NEEDSNEWMETADATA 指示验证错误可由组件在其方法的实现 ReinitializeMetaData 中修复。 SSIS 设计器将提示用户在调用组件后VS_NEEDSNEWMETADATA可以自行修复。ReinitializeMetaData
VS_ISCORRUPT 指示已损坏, ComponentMetaData 无法通过调用 ReinitializeMetaData 或编辑组件进行修复。

DelayValidation 数据流任务的属性为 true时,将消除对 Validate 的设计时间调用,并在组件执行之前调用该方法。

有关详细信息,请参阅验证数据流组件

适用于