IDTSDesigntimeComponent90.Validate Method
コンポーネントが正しく構成されていることを確認します。
名前空間: Microsoft.SqlServer.Dts.Pipeline.Wrapper
アセンブリ: Microsoft.SqlServer.DTSPipelineWrap (microsoft.sqlserver.dtspipelinewrap.dll 内)
構文
'宣言
<DispIdAttribute(29)> _
Function Validate As DTSValidationStatus
[DispIdAttribute(29)]
DTSValidationStatus Validate ()
[DispIdAttribute(29)]
DTSValidationStatus Validate ()
/** @attribute DispIdAttribute(29) */
DTSValidationStatus Validate ()
DispIdAttribute(29)
function Validate () : DTSValidationStatus
戻り値
コンポーネントの状態を示す DTSValidationStatus 列挙の値です。
解説
Validate メソッドは、コンポーネントが正しく構成されていることを確認するために、コンポーネント開発者によって実装されます。パッケージ デザインの間、およびコンポーネントの実行前に一度、繰り返して呼び出されます。コンポーネントは、Validate 中に IDTSComponentMetaData90 を変更しません。
各コンポーネントで検証が正常終了するための要件は異なりますが、次の一覧に、検証の必要がある一般的な項目のいくつかを示します。
コンポーネントが予期された数の IDTSInput90 オブジェクトおよび IDTSOutput90 オブジェクトを持っていることを確認します。
任意の IDTSCustomProperty90 オブジェクトが引き続き存在し、正しい値を含むことを確認します。
IDTSInputColumnCollection90 の各 IDTSInputColumn90 オブジェクトが上流コンポーネントの既存の IDTSOutputColumn90 オブジェクトを参照することを確認します。
コンポーネントが接続を使用する場合、IDTSRuntimeConnection90 が指定され、ConnectionManager がパッケージに存在することを確認します。
コンポーネントは、検証に失敗するとユーザーにフィードバックを提供する必要があります。フィードバックは、FireError メソッドと FireWarning メソッドを介して提供され、DTSValidationStatus 戻り値で示されます。FireError メソッドと FireWarning メソッドへの呼び出しは Business Intelligence Development Studio の [タスク一覧] ウィンドウに表示され、ユーザーに検証の失敗に関する手引きを示します。DTSValidationStatus 列挙の 4 つの値のうち、VS_ISVALID だけが検証の正常終了を示します。他の 3 つの値は、さまざまなレベルの失敗を示します。次の表に、列挙の失敗の値と、それらが SSIS デザイナによってどのように解釈されるかを示します。
状態 |
説明 |
コンポーネントが正しく構成されていないことを示します。ユーザーは、問題を解決するために ComponentMetaData を変更する必要があります。 |
|
検証エラーが ReinitializeMetaData メソッドの実装において、コンポーネントによって修正可能であることを示します。SSIS デザイナは、列挙値が VS_NEEDSNEWMETADATA である場合、コンポーネントがそれ自体を修復できることをユーザーに示します。次に、デザイナは、ReinitializeMetaData メソッドを呼び出します。 |
|
ComponentMetaData が壊れていて、ReinitializeMetaData メソッドの呼び出しまたはコンポーネントの編集によって修復できないことを示します。 |
データ フロー タスクの DelayValidation プロパティが true である場合、Validate メソッドのデザイン時呼び出しは除去され、代わりにコンポーネントの実行前にメソッドが呼び出されます。
スレッド セーフ
この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォーム
開発プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
対象プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
参照
関連項目
IDTSDesigntimeComponent90 Interface
IDTSDesigntimeComponent90 Members
Microsoft.SqlServer.Dts.Pipeline.Wrapper Namespace