MessageQueueTask.Validate メソッド

定義

名前空間:

Microsoft.SqlServer.Dts.Tasks.MessageQueueTask

アセンブリ:

Microsoft.SqlServer.MSMQTask.dll

タスクが正しく構成されていることを確認します。

public:
 override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult

パラメーター

connections

Connections

タスクで使用される接続のコレクションです。

variableDispenser

VariableDispenser

変数をロックするための VariableDispenser オブジェクトです。

events

IDTSComponentEvents

IDTSComponentEvents インターフェイスを実装するオブジェクトです。

log

IDTSLogging

IDTSLogging インターフェイスを実装するオブジェクトです。

戻り値

DTSExecResult

DTSExecResult 列挙体の値。

例

次のコード例では、Package オブジェクトの Validate メソッドを使用してオブジェクトを検証します。

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

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

注釈

Validate メソッドは、不正確または不適切な設定がないかプロパティと設定を確認します。 このメソッドは、データを修正したり、接続を検証するためにデータ ソースに接続することはありません。 ただし、必要なフィールドにデータが設定され、適切な値が含まれているかどうかを確認します。 検証されるフィールドは、検証するオブジェクトの種類によって異なります。

Validate は主に、カスタム タスクを作成する際に使用します。 この Validate メソッドは、タスクがデザイン サーフェイスにドロップされたときに SSIS デザイナーによって呼び出され、プロパティが設定されている場合は複数回呼び出される可能性があります。 ただし、コードで、個々のオブジェクトで Validate メソッドを使用するのは一般的ではありません。オブジェクトを検証する必要がある場合は、Package で Validate メソッドを呼び出すことをお勧めします。 ただし、このメソッドを必要とする特定の状況においては、個々のオブジェクトでこのメソッドを使用できます。

Validate メソッドは、SSIS デザイナーで使用される場合にはオブジェクトの検証のために、またはコードで呼び出された場合に、カスタム タスクでオーバーライドされます。 カスタム タスクのメソッドの Validate 記述の詳細については、「カスタム タスク のコーディング」を参照してください。