IDTSDesigntimeComponent100.Validate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2012::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus Validate();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatusPublic Function Validate () As DTSValidationStatus返品
DTSValidationStatus列挙からのコンポーネントの状態を示す値です。
- 属性
注釈
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 | コンポーネントが正しく設定されていないことを示します。 ユーザーは問題を解決するためにコンポーネントメタデータの変更を行う必要があります。 |
| VS_NEEDSNEWMETADATA | ReinitializeMetaDataメソッドの実装において、コンポーネントが検証エラーを修正できることを示します。 列挙値がVS_NEEDSNEWMETADATAされると、SSISデザイナーはコンポーネントが自己修復できるようユーザーに促します。 その後、デザイナーはReinitializeMetaDataメソッドを呼び出します。 |
| VS_ISCORRUPT | コンポーネントメタデータが破損しており、ReinitializeMetaDataメソッドの呼び出しやコンポーネントの編集で修復できないことを示します。 |
データフロータスクのDelayValidationプロパティが 真の場合、Validateメソッドへの設計時呼び出しは省略され、代わりにコンポーネント実行前にメソッドが呼び出されます。