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 返回值提供。 调用 FireErrorFireWarning 方法的操作会显示在 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 性质为 时,设计时调用验证方法的请求被取消,该方法在组件执行前被调用。

适用于