ForEachEnumerator.Validate 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
允许容器判断是否包含无效设置,导致无法成功执行。
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);
public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overridable Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResult
参数
- connections
- Connections
的 Connections 集合 ForEachEnumerator。
- variableDispenser
- VariableDispenser
Variables集装箱的收款。
- infoEvents
- IDTSInfoEvents
一个在持久化期间实现 IDTSInfoEvents 触发事件(错误、警告等)接口的对象。
- log
- IDTSLogging
一个 IDTSLogging 接口。
返回
枚举中的一个值 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 方法的更多信息,请参见 “自定义任务编码”。