PipelineComponent.Validate 方法

定义

命名空间:

Microsoft.SqlServer.Dts.Pipeline

程序集:

Microsoft.SqlServer.PipelineHost.dll

重要

此 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

枚举中的 DTSValidationStatus 一个值，表示组件的状态。

属性

CLSCompliantAttribute

注解

组件开发者会覆盖该 Validate 方法，以验证组件的正确配置。 在包设计过程中会反复调用一次，在组件执行前调用一次。 组件不应在 期间进行修改。ComponentMetaDataValidate

基础类实现Validate会检查上游组件中属性不匹配LineageIDIDTSOutputColumn100的对象LineageID是否存在IDTSInputColumn100。 组件开发者应通过对 . 进行额外检查ComponentMetaData来扩展基础类Validate功能。 每个组件对成功验证的要求不同，但以下列表列出了一些常见的验证项目。

• 验证组件是否拥有预期数量 IDTSInput100 的 和 IDTSOutput100 对象。

• 验证任何 IDTSCustomProperty100 对象是否仍然存在，且包含正确的值。

• 如果组件使用连接，它应验证 是 IDTSRuntimeConnection100 被指定且 ConnectionManager 包中是否存在。

组件应在验证失败时向用户提供反馈。 反馈通过 and FireErrorFireWarning 方法和 DTSValidationStatus 返回值提供。 调用FireError和FireWarning的操作显示在SQL Server Data Tools（SSDT）的错误列表窗口中，应为用户提供验证失败的指导。 枚举中的 DTSValidationStatus 四个值中，仅 VS_ISVALID 表示验证成功。 另外三个数值表示不同的故障程度。 下表描述了枚举中的故障值以及SSIS设计器如何解释这些值。

地位	Description
VS_ISBROKEN	表示组件配置不正确，但用户 ComponentMetaData 对 的更改将解决问题。
VS_NEEDSNEWMETADATA	表示组件在方法 ReinitializeMetaData 实现时可以修复验证错误。 SSIS Designer 会提示用户该组件可以自行修复，当 VS_NEEDSNEWMETADATA，随后 ReinitializeMetaData 被调用时。
VS_ISCORRUPT	表示该组件 ComponentMetaData 损坏，无法通过调用 ReinitializeMetaData 或编辑组件修复。

当 DelayValidation 数据流任务的属性为 true时，设计时间调用 Validate 被省略，方法在组件执行前被调用。

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