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 ，以验证是否已正确配置该组件。 它在包设计期间反复调用，并在组件执行前一次调用。 组件不应在 ComponentMetaData .Validate

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

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

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

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

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

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

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

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