次の方法で共有

Parameter オブジェクト

  • [アーティクル]

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

解説

多くのプロバイダーでは、パラメーター化されたコマンドがサポートされています。 これらは目的のアクションを一旦定義するコマンドですが、変数 (またはパラメーター) を使用してコマンドの詳細を変更できます。 たとえば、SQL SELECT ステートメントでは、パラメーターを使用して WHERE 句の一致条件を定義し、もう 1 つを使用して 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 オブジェクトでのスクリプト作成は安全ではありません。

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

参照

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