IDTSDesigntimeComponent100.Validate 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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 。
每个组件对成功验证的要求不同,但以下列表列出了一些常见的验证项目。
验证组件是否拥有预期数量 IDTSInput100 的 和 IDTSOutput100 对象。
验证任何 IDTSCustomProperty100 对象是否仍然存在且包含正确的数值。
验证其每个IDTSInputColumn100对象 IDTSInputColumnCollection100 是否引用上游组件中的一个现有 IDTSOutputColumn100 对象。
如果组件使用连接,请确认 是 IDTSRuntimeConnection100 指定 ConnectionManager 且包中是否存在。
组件应在验证失败时向用户提供反馈。 反馈通过 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 性质为 真时,设计时调用验证方法的请求被取消,该方法在组件执行前被调用。