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
是编写自定义任务。 当 Validate
任务被拖放到设计图面上时,SSIS 设计器会调用该方法,在设置属性时,可能会多次调用该方法。 但是,在代码中, Validate
单个对象上的方法并不常用,因为建议在需要验证对象时调用 Validate
该方法 Package 。 但是,如果发现需要该方法的唯一情况,则可以对各个对象使用该方法。
在 Validate
自定义任务中重写该方法,无论是在 SSIS 设计器中使用对象还是由代码调用时验证对象。 有关编写 Validate
自定义任务的方法的详细信息,请参阅 编写自定义任务编码。