ForEachSMOEnumerator.Validate メソッド

コンテナーの正常実行を妨げる無効な設定がコンテナーに含まれていないかどうかを示す値を返します。

名前空間:  Microsoft.SqlServer.Dts.Runtime.Enumerators.SMO
アセンブリ:  Microsoft.SqlServer.ForEachSMOEnumerator (Microsoft.SqlServer.ForEachSMOEnumerator.dll)

構文

'宣言
Public Overrides Function Validate ( _
    connections As Connections, _
    variableDispenser As VariableDispenser, _
    events As IDTSInfoEvents, _
    log As IDTSLogging _
) As DTSExecResult
'使用
Dim instance As ForEachSMOEnumerator 
Dim connections As Connections 
Dim variableDispenser As VariableDispenser 
Dim events As IDTSInfoEvents 
Dim log As IDTSLogging 
Dim returnValue As DTSExecResult 

returnValue = instance.Validate(connections, _
    variableDispenser, events, log)

public override DTSExecResult Validate(
    Connections connections,
    VariableDispenser variableDispenser,
    IDTSInfoEvents events,
    IDTSLogging log
)

public:
virtual DTSExecResult Validate(
    Connections^ connections, 
    VariableDispenser^ variableDispenser, 
    IDTSInfoEvents^ events, 
    IDTSLogging^ log
) override

abstract Validate : 
        connections:Connections * 
        variableDispenser:VariableDispenser * 
        events:IDTSInfoEvents * 
        log:IDTSLogging -> DTSExecResult  
override Validate : 
        connections:Connections * 
        variableDispenser:VariableDispenser * 
        events:IDTSInfoEvents * 
        log:IDTSLogging -> DTSExecResult

public override function Validate(
    connections : Connections, 
    variableDispenser : VariableDispenser, 
    events : IDTSInfoEvents, 
    log : IDTSLogging
) : DTSExecResult

パラメーター

• connections
  型: Microsoft.SqlServer.Dts.Runtime.Connections
  コンテナーの Connections コレクションです。

• variableDispenser
  型: Microsoft.SqlServer.Dts.Runtime.VariableDispenser
  コンテナーの VariableDispenser コレクションです。

• events
  型: Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents
  イベントを発生させるための IDTSInfoEvents インターフェイスです。

• log
  型: Microsoft.SqlServer.Dts.Runtime.IDTSLogging
  IDTSLogging インターフェイスです。

戻り値

型: Microsoft.SqlServer.Dts.Runtime.DTSExecResult
検証の結果を示す DTSExecResult 列挙です。

実装

IDTSForEachEnumerator.Validate(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging)

説明

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

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

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

使用例

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

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

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

関連項目

参照

ForEachSMOEnumerator クラス

Microsoft.SqlServer.Dts.Runtime.Enumerators.SMO 名前空間