语言

IDTSDesigntimeComponent100.Validate 方法

定义

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 。

每个组件对成功验证的要求不同,但以下列表列出了一些常见的验证项目。

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

地位 Description
VS_ISBROKEN 表示该组件配置不正确。 用户必须对 进行 ComponentMetaData 修改以解决这些问题。
VS_NEEDSNEWMETADATA 表示组件在方法 ReinitializeMetaData 实现时可以修复验证错误。 当枚举值VS_NEEDSNEWMETADATA时,SSIS设计器会提示组件可以自我修复。 然后设计师会调用 ReinitializeMetaData 该方法。
VS_ISCORRUPT 表示 已 ComponentMetaData 损坏,无法通过调用 ReinitializeMetaData 方法或编辑组件来修复。

当数据流任务的 DelayValidation 性质为 真时,设计时调用验证方法的请求被取消,该方法在组件执行前被调用。

适用于