IDTSDesigntimeComponent100.Validate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コンポーネントが正しく構成されていることを確認します。
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Function Validate () As DTSValidationStatus戻り値
コンポーネントの状態を示す DTSValidationStatus 列挙の値です。
- 属性
注釈
Validate メソッドは、コンポーネントが正しく構成されていることを確認するために、コンポーネント開発者によって実装されます。 パッケージのデザイン時、およびコンポーネントの実行前に一度、繰り返して呼び出されます。 コンポーネントは、IDTSComponentMetaData100 の間は Validate を変更しません。
各コンポーネントで検証が正常終了するための要件は異なりますが、次の一覧に、検証の必要がある一般的な項目のいくつかを示します。
コンポーネントが予期された数の IDTSInput100 オブジェクトおよび IDTSOutput100 オブジェクトを持っていることを確認します。
オブジェクト IDTSCustomProperty100 が引き続き存在し、正しい値が含まれていることを確認します。
IDTSInputColumn100 の各 IDTSInputColumnCollection100 オブジェクトが上流コンポーネントの既存の IDTSOutputColumn100 オブジェクトを参照することを確認します。
コンポーネントが接続を使用する場合、IDTSRuntimeConnection100 が指定され、ConnectionManager がパッケージに存在することを確認します。
コンポーネントは、検証に失敗するとユーザーにフィードバックを提供する必要があります。 フィードバックは、FireError メソッドと FireWarning メソッドを介して提供され、DTSValidationStatus 戻り値で示されます。 FireErrorメソッドの呼び出しFireWarningは、SQL Server Data Tools (SSDT) の [タスク一覧] ウィンドウに表示され、検証エラーに関するガイダンスをユーザーに提供する必要があります。 DTSValidationStatus 列挙の 4 つの値のうち、VS_ISVALID だけが検証の正常終了を示します。 他の 3 つの値は、さまざまなレベルの失敗を示します。 次の表は、列挙体のエラー値と、それらが SSIS デザイナーによってどのように解釈されるかを示しています。
| Status | 説明 |
|---|---|
| VS_ISBROKEN | コンポーネントが正しく構成されていないことを示します。 ユーザーは、問題を解決するために ComponentMetaData を変更する必要があります。 |
| VS_NEEDSNEWMETADATA | 検証エラーが ReinitializeMetaData メソッドの実装において、コンポーネントによって修正可能であることを示します。 SSIS デザイナーは、列挙値 VS_NEEDSNEWMETADATAが指定されている場合にコンポーネント自体を修復できることをユーザーに求めます。 次に、デザイナーは、ReinitializeMetaData メソッドを呼び出します。 |
| VS_ISCORRUPT | ComponentMetaData が壊れていて、ReinitializeMetaData メソッドの呼び出しまたはコンポーネントの編集によって修復できないことを示します。 |
データ フロー タスクの DelayValidation プロパティが true である場合、Validate メソッドのデザイン時呼び出しは除去され、代わりにコンポーネントの実行前にメソッドが呼び出されます。