InitializeParameters メソッド

指定した IDbCommand オブジェクトの IDataParameterCollection コレクションを、要求されるパラメーター スキーマに基づいて初期化します

シンタックス

Visual Basic

public IDataParameterCollection InitializeParameters( 
   IDbCommand currentCommand,
   OperationContext.ParameterFactoryMethod factoryMethod,
   int commandSequenceNumber
)

C#

'宣言
 
Public Function InitializeParameters( _
   ByVal currentCommand As IDbCommand, _
   ByVal factoryMethod As OperationContext.ParameterFactoryMethod, _
   ByVal commandSequenceNumber As Integer _
) As IDataParameterCollection

 

パラメータ

currentCommand

パラメーターを再初期化する現在の IDbCommand オブジェクト。

factoryMethod

新しい IDbDataParameter 実装の作成に使用するファクトリ メソッド。通常これは currentCommand　に渡されたのと同じ IDbCommand　実装型の CreateParameter　メソッドですが、独自に WebScheduleDBProvider　をサブクラス化して CreateParameter　メソッドをオーバーライドした場合は必ずしもそうとは限りません。

commandSequenceNumber

operation は (特に動的SQLモードでは) 一連のステップで構成されるため、この数字 (ゼロから始まる) は operation の処理のステップを示します。これは要求されるパラメーター スキーマに影響を与えます。

戻り値の型

currentCommand のスコープ内 OperationContext の処理ステップ commandSequenceNumber で要求されるパラメーター スキーマで初期化された IDataParameterCollection 。呼び出し元では 入力パラメーター の初期化を完了するために、さらに引数値を格納する必要があります。

例外

例外	解説
System.ArgumentNullException	指定したcurrentCommand が null （Visual Basic .NET では Nothing) の場合にスローされます。適切な実装型のデータ パラメーター コレクションを作成してそれを currentCommand に関連付けるためには、null でないIDbCommand 実装が必要です。

解説

このメソッドを呼び出すと、currentCommand　の IDataParameterCollection がいったん空にリセットされてから、処理のこのステップで要求されるパラメーターセットが追加されます。