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メソッドはコンポーネント開発者によって実装され、コンポーネントが正しく設定されていることを検証します。 パッケージ設計中に繰り返し呼び出され、コンポーネントの実行前に一度だけ呼び出されます。 部品はValidate中にIDTSComponentMetaData100を変更してはいけません。
各コンポーネントには検証成功のための要件が異なりますが、以下のリストでは検証すべき一般的な項目をいくつか紹介します。
コンポーネントが期待される数の IDTSInput100 と IDTSOutput100 オブジェクトを持っているかを確認しましょう。
どの IDTSCustomProperty100 オブジェクトも存在し続け、正しい値を含んでいるか確認してください。
各 IDTSInputColumn100 オブジェクトが IDTSInputColumnCollection100 上の IDTSOutputColumn100 オブジェクトを参照していることを確認しましょう。
コンポーネントが接続を使用している場合は、 IDTSRuntimeConnection100 が指定されていること、そしてパッケージ内に ConnectionManager が存在することを確認しましょう。
コンポーネントは検証に失敗した際にユーザーにフィードバックを提供するべきです。 フィードバックは FireError 法および FireWarning 法、そして DTSValidationStatus 戻り値によって提供されます。 FireErrorメソッドおよびFireWarningメソッドへの呼び出しは、SQL Server Data Tools(SSDT)のタスクリストウィンドウに表示され、検証失敗に関するユーザーの指針となります。 DTSValidationStatus列挙の4つの値のうち、検証が成功したことを示すのはVS_ISVALIDだけです。 他の3つの値は故障のレベルが異なります。 以下の表は、列挙中の故障値とSSIS Designerによる解釈方法を説明しています。
| 地位 | 説明 |
|---|---|
| VS_ISBROKEN | コンポーネントが正しく設定されていないことを示します。 ユーザーは問題を解決するために ComponentMetaData に変更を加える必要があります。 |
| VS_NEEDSNEWMETADATA | ReinitializeMetaDataメソッドの実装において、コンポーネントが検証エラーを修正できることを示します。 列挙値が VS_NEEDSNEWMETADATAされると、SSIS設計者はコンポーネントが自己修復できるとユーザーに促します。 その後、設計者が ReinitializeMetaData メソッドを呼び出します。 |
| VS_ISCORRUPT | ComponentMetaDataが破損しており、ReinitializeMetaDataメソッドへの呼び出しやコンポーネントの編集で修復できないことを示します。 |
データフロータスクの DelayValidation プロパティが trueされると、 Validate メソッドへの設計時呼び出しは省略され、代わりにコンポーネント実行前にメソッドが呼び出されます。