LogProviderBase.Validate(IDTSInfoEvents) 方法

定义

调用以确认日志提供程序的配置正确。

public:
 virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);
public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);
abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResult

参数

events
IDTSInfoEvents

用于在包执行期间激发信息性事件的 IDTSInfoEvents 接口。

返回

DTSExecResult

DTSExecResult 结构中指示验证是成功还是失败的值。

示例

下面的代码示例演示如何使用对象的方法验证对象 Validate Package

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

注解

Validate方法检查属性和设置是否有错误或不正确的设置。 方法不触及数据,或连接到数据源以验证连接。 但是,它可确保填写必填字段,并包含相应的值。 验证的字段因要验证的对象而异。 对于日志提供程序, Validate 方法验证是否 ConfigString 正确配置了属性,以及日志提供程序所需的任何其他属性或设置是否设置为预期。 需要连接到外部数据源的日志提供程序通过使用对象实现此目的 ConnectionManagerConfigString属性通常用于保存集合中的的名称或 ID ConnectionManager Connections

在这种情况下, Validate 应验证 ConnectionManager ConfigString 包中是否存在属性中指定的。

如果 Failure 返回,则取消包执行。

的主要用途 Validate 是编写自定义任务。 Validate当设置属性时,SSIS 设计器会调用方法,这种方法在将任务拖放到设计图面上并再次出现。 但是,在代码中, Validate 不常用于单个对象的方法,因为 Validate Package 当你需要验证对象时,建议在上调用方法。 但是,在单独的对象上提供方法时,应在需要时找到独特的情况。

Validate 自定义任务中将重写方法,以用于在 SSIS 设计器中使用或由代码调用时的对象验证。 有关编写 Validate 自定义任务的方法的详细信息,请参阅 编写自定义任务的代码

适用于