LogProviderBase.Validate(IDTSInfoEvents) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ログ プロバイダーが正しく構成されていることを確認するために呼び出されます。
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.DTSExecResultPublic Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResultパラメーター
- events
- IDTSInfoEvents
パッケージの実行中に情報イベントを起動するために使用される IDTSInfoEvents インターフェイスです。
戻り値
検証が成功したか失敗したかを示す DTSExecResult 構造の値です。
例
Package オブジェクトの Validate メソッドを使用してオブジェクトを検証するコード例を次に示します。
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)
注釈
Validate メソッドは、不正確または不適切な設定がないかプロパティと設定を確認します。 このメソッドは、データを修正したり、接続を検証するためにデータ ソースに接続することはありません。 ただし、必要なフィールドにデータが設定され、適切な値が含まれているかどうかを確認します。 検証されるフィールドは、検証するオブジェクトの種類によって異なります。 ログ プロバイダーの場合、Validate メソッドは、ConfigString プロパティが正しく構成され、ログ プロバイダーに必要なその他のプロパティまたは設定が期待どおりに設定されていることを確認します。 外部データ ソースへの接続を必要としているログ プロバイダーは、ConnectionManager オブジェクトを使用して、このような接続を行います。 ConfigString プロパティは、多くの場合、ConnectionManager コレクション内の Connections の名前または ID を保持するために使用されます。
この場合、Validate は、ConnectionManager プロパティで指定された ConfigString がパッケージ内に存在することを確認する必要があります。
Failure が返される場合、パッケージの実行は取り消されます。
Validate は主に、カスタム タスクを作成する際に使用します。 Validate メソッドは、タスクをデザイン画面上にドロップしたときに SSIS デザイナーによって呼び出されます。また、その後でプロパティを設定する際にも毎回呼び出されます。 ただし、コードで、個々のオブジェクトで Validate メソッドを使用するのは一般的ではありません。オブジェクトを検証する必要がある場合は、Package で Validate メソッドを呼び出すことをお勧めします。 ただし、このメソッドを必要とする特定の状況においては、個々のオブジェクトでこのメソッドを使用できます。
Validate メソッドは、SSIS デザイナーで使用される場合にはオブジェクトの検証のために、またはコードで呼び出された場合に、カスタム タスクでオーバーライドされます。 カスタム タスクのメソッドの Validate 記述の詳細については、「カスタム タスク のコーディング」を参照してください。