次の方法で共有


Executable.Validate Method

実行可能ファイルを実行する前に、すべての依存関係とその他の項目を検証することにより、オブジェクトが正常に実行されることを確認します。このメソッドを実装するコンポーネントが検証対象になります。

名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (microsoft.sqlserver.manageddts.dll 内)

構文

'宣言
Public MustOverride Function Validate ( _
    connections As Connections, _
    variables As Variables, _
    events As IDTSEvents, _
    log As IDTSLogging _
) As DTSExecResult
public abstract DTSExecResult Validate (
    Connections connections,
    Variables variables,
    IDTSEvents events,
    IDTSLogging log
)
public:
virtual DTSExecResult Validate (
    Connections^ connections, 
    Variables^ variables, 
    IDTSEvents^ events, 
    IDTSLogging^ log
) abstract
public abstract DTSExecResult Validate (
    Connections connections, 
    Variables variables, 
    IDTSEvents events, 
    IDTSLogging log
)
public abstract function Validate (
    connections : Connections, 
    variables : Variables, 
    events : IDTSEvents, 
    log : IDTSLogging
) : DTSExecResult

パラメータ

  • variables
    Variables コレクションです。
  • events
    イベントを発生させるための IDTSEvents インターフェイスです。

戻り値

実行可能ファイルの検証結果を示す値を DTSExecResult 列挙から返します。検証結果は、成功、失敗、またはその他の状態のいずれかになります。

解説

Validate メソッドは、不正確または不適切な設定がないかプロパティと設定を確認します。このメソッドは、データを修正したり、接続を検証するためにデータ ソースに接続することはありません。ただし、必要なフィールドが設定され、適切な値が含まれているかどうかを確認します。検証されるフィールドは、検証するオブジェクトの種類によって異なります。

Validate は主に、カスタム タスクを作成する際に使用します。Validate メソッドは、タスクをデザイン画面上にドロップしたときに SSIS デザイナによって呼び出されます。また、その後でプロパティを設定する際にも毎回呼び出されます。コードでは、個々のオブジェクトで Validate メソッドを使用するのは一般的ではありません。オブジェクトを検証する必要がある場合は PackageValidate メソッドを呼び出すことをお勧めします。ただし、このメソッドを必要とする特定の状況においては、個々のオブジェクトでこのメソッドを使用できます。

Validate メソッドは、SSIS デザイナで使用される場合にはオブジェクトの検証のために、またはコードで呼び出された場合に、カスタム タスクでオーバーライドされます。カスタム タスクの Validate メソッド作成の詳細については、「カスタム タスクのコーディング」を参照してください。

使用例

次のコード例では、Package オブジェクトの Validate メソッドを使用してオブジェクトを検証します。

DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult =  pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

Executable Class
Executable Members
Microsoft.SqlServer.Dts.Runtime Namespace