Executable.Validate メソッド
実行可能ファイルを実行する前に、すべての依存関係とその他の項目を検証することにより、オブジェクトが正常に実行されることを確認します。 このメソッドを実装するコンポーネントが検証対象になります。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public MustOverride Function Validate ( _
connections As Connections, _
variables As Variables, _
events As IDTSEvents, _
log As IDTSLogging _
) As DTSExecResult
'使用
Dim instance As Executable
Dim connections As Connections
Dim variables As Variables
Dim events As IDTSEvents
Dim log As IDTSLogging
Dim returnValue As DTSExecResult
returnValue = instance.Validate(connections, _
variables, events, log)
public abstract DTSExecResult Validate(
Connections connections,
Variables variables,
IDTSEvents events,
IDTSLogging log
)
public:
virtual DTSExecResult Validate(
Connections^ connections,
Variables^ variables,
IDTSEvents^ events,
IDTSLogging^ log
) abstract
abstract Validate :
connections:Connections *
variables:Variables *
events:IDTSEvents *
log:IDTSLogging -> DTSExecResult
public abstract function Validate(
connections : Connections,
variables : Variables,
events : IDTSEvents,
log : IDTSLogging
) : DTSExecResult
パラメーター
- connections
型: Microsoft.SqlServer.Dts.Runtime.Connections
Connections コレクションです。
- variables
型: Microsoft.SqlServer.Dts.Runtime.Variables
Variables コレクションです。
- events
型: Microsoft.SqlServer.Dts.Runtime.IDTSEvents
イベントを発生させるための IDTSEvents インターフェイスです。
- log
型: Microsoft.SqlServer.Dts.Runtime.IDTSLogging
IDTSLogging インターフェイスです。
戻り値
型: Microsoft.SqlServer.Dts.Runtime.DTSExecResult
実行可能ファイルの検証結果を示す値を DTSExecResult 列挙から返します。検証結果は、成功、失敗、またはその他の状態のいずれかになります。
説明
Validate メソッドは、不正確または不適切な設定がないかプロパティと設定を確認します。 このメソッドは、データを修正したり、接続を検証するためにデータ ソースに接続することはありません。 ただし、必要なフィールドにデータが設定され、適切な値が含まれているかどうかを確認します。 検証されるフィールドは、検証するオブジェクトの種類によって異なります。
Validate は主に、カスタム タスクを作成する際に使用します。 Validate メソッドは、タスクをデザイン画面上にドロップしたときに SSIS デザイナーによって呼び出されます。また、その後でプロパティを設定する際にも毎回呼び出されます。 ただし、コードで、個々のオブジェクトで Validate メソッドを使用するのは一般的ではありません。オブジェクトを検証する必要がある場合は、Package で Validate メソッドを呼び出すことをお勧めします。 ただし、このメソッドを必要とする特定の状況においては、個々のオブジェクトでこのメソッドを使用できます。
Validate メソッドは、SSIS デザイナーで使用される場合にはオブジェクトの検証のために、またはコードで呼び出された場合に、カスタム タスクでオーバーライドされます。 カスタム タスクの Validate メソッド作成の詳細については、「カスタム タスクのコーディング」を参照してください。
使用例
Package オブジェクトの Validate メソッドを使用してオブジェクトを検証するコード例を次に示します。
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)