CreateParameter メソッド (ADO)

指定されたプロパティを持つ新しい Parameter オブジェクトを作成します。

構文

  
Set parameter = command.CreateParameter (Name, Type, Direction, Size, Value)  

戻り値

Parameter オブジェクトを返します。

パラメーター

名前
省略可能。 Parameter オブジェクトの名前を表す String 値。

Type
省略可能。 Parameter オブジェクトのデータ型を指定する DataTypeEnum 値。

方向
省略可能。 Parameter オブジェクトの型を指定する ParameterDirectionEnum 値。

[サイズ]
省略可能。 文字単位またはバイト単位でパラメーター値の最大長を指定する Long 値。

Value
省略可能。 Parameter オブジェクトの値を指定する Variant 値。

注釈

CreateParameter メソッドを使って、指定した名前、型、方向、サイズ、値を持つ新しい Parameter オブジェクトを作成します。 引数で渡した値はすべて、対応する Parameter プロパティに書き込まれます。

このメソッドでは、Parameter オブジェクトは Command オブジェクトの Parameters コレクションに自動的に追加されません。 これにより、Parameter オブジェクトをコレクションに追加するときに、ADO が値を検証する追加のプロパティを設定できます。

Type 引数に可変長データ型を指定する場合は、Size 引数を渡すか、Parameter オブジェクトの Size プロパティを設定してから Parameters コレクションに追加する必要があり、それ以外の場合はエラーが発生します。

数値データ型 (adNumeric または adDecimal) を Type 引数に指定した場合は、NumericScale と Precision プロパティを設定することも必要です。

適用対象

Command オブジェクト (ADO)

参照

Append および CreateParameter メソッドの例 (VB)
Append および CreateParameter メソッドの例 (VC++)
Append メソッド (ADO)
Parameter オブジェクト
Parameters コレクション (ADO)