Validate メソッド

構文

'宣言
Function Validate As DTSValidationStatus
'使用
Dim instance As IDTSDesigntimeComponent100
Dim returnValue As DTSValidationStatus

returnValue = instance.Validate()

DTSValidationStatus Validate()

DTSValidationStatus Validate()

abstract Validate : unit -> DTSValidationStatus 

function Validate() : DTSValidationStatus

説明

Validate メソッドは、コンポーネントが正しく構成されていることを確認するために、コンポーネント開発者によって実装されます。パッケージのデザイン時、およびコンポーネントの実行前に一度、繰り返して呼び出されます。コンポーネントは、Validate の間は IDTSComponentMetaData100 を変更しません。

各コンポーネントで検証が正常終了するための要件は異なりますが、次の一覧に、検証の必要がある一般的な項目のいくつかを示します。

• コンポーネントが予期された数の IDTSInput100 オブジェクトおよび IDTSOutput100 オブジェクトを持っていることを確認します。

• 任意の IDTSCustomProperty100 オブジェクトが引き続き存在し、正しい値を含むことを確認します。

• IDTSInputColumnCollection100 の各 IDTSInputColumn100 オブジェクトが上流コンポーネントの既存の IDTSOutputColumn100 オブジェクトを参照することを確認します。

• コンポーネントが接続を使用する場合、IDTSRuntimeConnection100 が指定され、ConnectionManager がパッケージに存在することを確認します。

コンポーネントは、検証に失敗するとユーザーにフィードバックを提供する必要があります。フィードバックは、FireError メソッドと FireWarning メソッドを介して提供され、DTSValidationStatus 戻り値で示されます。FireError メソッドと FireWarning メソッドの呼び出しは、Business Intelligence Development Studio の [タスク一覧] ウィンドウに表示され、ユーザーに検証の失敗に関する手引きを示します。DTSValidationStatus 列挙の 4 つの値のうち、VS_ISVALID だけが検証の正常終了を示します。他の 3 つの値は、さまざまなレベルの失敗を示します。次の表に、列挙内の失敗の値と、それらが SSIS デザイナでどのように解釈されるかを示します。

データ フロー タスクの DelayValidation プロパティが true である場合、Validate メソッドのデザイン時呼び出しは除去され、代わりにコンポーネントの実行前にメソッドが呼び出されます。

関連項目

参照