Executable.Validate(Connections, Variables, IDTSEvents, IDTSLogging) 方法

定义

命名空间:

Microsoft.SqlServer.Dts.Runtime

程序集:

Microsoft.SqlServer.ManagedDTS.dll

在执行前，通过验证所有依赖和其他项，验证可执行文件是否能成功执行。 实现该方法的组件就是被验证的组件。

public:
 abstract Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::Variables ^ variables, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public abstract Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.Variables variables, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.Variables * Microsoft.SqlServer.Dts.Runtime.IDTSEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public MustOverride Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResult

参数

connections

Connections

集合 Connections 。

variables

Variables

集合 Variables 。

events

IDTSEvents

一个 IDTSEvents 用来引发事件的界面。

log

IDTSLogging

一个 IDTSLogging 接口。

返回

DTSExecResult

返回枚举中的一个值 DTSExecResult ，表示验证可执行文件的成功、失败或其他状态。

示例

以下代码示例展示了如何使用 Validate 对象的方法 Package 验证对象。

DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);  

Dim myresult As DTSExecResult =  pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)  

注解

该 Validate 方法会审查属性和设置的不准确或错误设置。 该方法不接触数据，也不连接数据源以验证连接。 但它确保所需字段被填充并包含适当的值。 被验证的字段因被验证对象而异。

主要用途 Validate 是在编写自定义任务时。 当任务被丢到设计表面时，SSIS设计师会调用该 Validate 方法，在设置属性时也可能多次调用。 然而，在代码中，针对单个对象的方法 Validate 并不常用，因为建议你 Validate 在需要验证对象时调用该方法 Package 。 不过，如果你遇到特殊情况，这种方法也可以在单个物体上使用。

Validate该方法在自定义任务中被覆盖，无论是在 SSIS 设计器中使用时用于验证对象，还是在代码调用时。 关于为自定义任务编写 Validate 方法的更多信息，请参见 “自定义任务编码”。