IDTSDesigntimeComponent100.Validate メソッド
コンポーネントが正しく構成されていることを確認します。
名前空間: Microsoft.SqlServer.Dts.Pipeline.Wrapper
アセンブリ: Microsoft.SqlServer.DTSPipelineWrap (Microsoft.SqlServer.DTSPipelineWrap.dll)
構文
'宣言
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
戻り値
型: Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
コンポーネントの状態を示す DTSValidationStatus 列挙の値です。
説明
Validate メソッドは、コンポーネントが正しく構成されていることを確認するために、コンポーネント開発者によって実装されます。 パッケージのデザイン時、およびコンポーネントの実行前に一度、繰り返して呼び出されます。 コンポーネントは、Validate の間は IDTSComponentMetaData100 を変更しません。
各コンポーネントで検証が正常終了するための要件は異なりますが、次の一覧に、検証の必要がある一般的な項目のいくつかを示します。
コンポーネントが予期された数の IDTSInput100 オブジェクトおよび IDTSOutput100 オブジェクトを持っていることを確認します。
任意の IDTSCustomProperty100 オブジェクトが引き続き存在し、正しい値を含むことを確認します。
IDTSInputColumnCollection100 の各 IDTSInputColumn100 オブジェクトが上流コンポーネントの既存の IDTSOutputColumn100 オブジェクトを参照することを確認します。
コンポーネントが接続を使用する場合、IDTSRuntimeConnection100 が指定され、ConnectionManager がパッケージに存在することを確認します。
コンポーネントは、検証に失敗するとユーザーにフィードバックを提供する必要があります。 フィードバックは、FireError メソッドと FireWarning メソッドを介して提供され、DTSValidationStatus 戻り値で示されます。 FireError メソッドと FireWarning メソッドの呼び出しは、SQL Server データ ツール (SSDT) の [タスク一覧] ウィンドウに表示され、ユーザーに検証の失敗に関する手引きを示します。 DTSValidationStatus 列挙の 4 つの値のうち、VS_ISVALID だけが検証の正常終了を示します。 他の 3 つの値は、さまざまなレベルの失敗を示します。 次の表に、列挙内の失敗の値と、それらが SSIS デザイナーでどのように解釈されるかを示します。
状態 |
説明 |
|---|---|
コンポーネントが正しく構成されていないことを示します。 ユーザーは、問題を解決するために ComponentMetaData を変更する必要があります。 |
|
検証エラーが ReinitializeMetaData メソッドの実装において、コンポーネントによって修正可能であることを示します。 SSIS デザイナーは、列挙値が VS_NEEDSNEWMETADATA である場合、コンポーネントがそれ自体を修復できることをユーザーに示します。 次に、デザイナーは、ReinitializeMetaData メソッドを呼び出します。 |
|
ComponentMetaData が壊れていて、ReinitializeMetaData メソッドの呼び出しまたはコンポーネントの編集によって修復できないことを示します。 |
データ フロー タスクの DelayValidation プロパティが true である場合、Validate メソッドのデザイン時呼び出しは除去され、代わりにコンポーネントの実行前にメソッドが呼び出されます。