Parameter オブジェクト

パラメーター化されたクエリまたはストアド プロシージャに基づいて Command オブジェクトに関連付けられているパラメーターまたは引数を表します。

注釈

多くのプロバイダーでは、パラメーター化されたコマンドがサポートされています。 これらは目的のアクションを一旦定義するコマンドですが、変数 (またはパラメーター) を使用してコマンドの詳細を変更できます。 たとえば、SQL SELECT ステートメントでパラメーターを使用して WHERE 句の一致条件を定義し、別のパラメーターを使用して SORT BY 句の列名を定義できます。

パラメーター オブジェクトは、パラメーター化されたクエリに関連付けられているパラメーター、またはストアド プロシージャの in/out 引数と戻り値を表します。 プロバイダーの機能によっては、Parameter オブジェクトの一部のコレクション、メソッド、またはプロパティが使用できない場合があります。

Parameter オブジェクトのコレクション、メソッド、プロパティを使用すると、次のことができます。

• Name プロパティを使用してパラメーターの名前を設定するか、返します。

• Value プロパティを使用してパラメーターの値を設定するか、返します。 Value は、Parameter オブジェクトの既定のプロパティです。

• Attributes、Direction、Precision、NumericScale、Size、および Type プロパティ使用してパラメーターの特性を設定するか、返します。

• AppendChunk メソッドを使用して、長いバイナリ データまたは文字データをパラメーターに渡します。

• Properties コレクションを使用してプロバイダー固有の属性にアクセスします。

呼び出したいストアド プロシージャまたはパラメーター化クエリに関連付けられているパラメーターの名前とプロパティがわかっている場合は、CreateParameter メソッドを使用して適切なプロパティ設定で Parameter オブジェクトを作成し、Append メソッドを使用してそれらを Parameters コレクションに追加できます。 これによりパラメーター値を設定したり返したりでき、Parameters コレクションで Refresh メソッドを呼び出してプロバイダーからパラメーター情報を取得するという、多くのリソースを消費する操作が必要ありません。

Parameter オブジェクトでのスクリプト作成は安全ではありません。

このセクションでは、次のトピックを扱います。

• Parameter オブジェクトのプロパティ、メソッド、およびイベント

参照

Command オブジェクト (ADO)
CreateParameter メソッド (ADO)
Parameters コレクション (ADO)
Properties コレクション (ADO)