OracleParameter.Value プロパティ


パラメーターの値を取得または設定します。Gets or sets the value of the parameter.

 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public override object Value { get; set; }
member this.Value : obj with get, set
Public Overrides Property Value As Object


パラメーターの値を示すオブジェクト。An object that is the value of the parameter. 既定値は NULL です。The default value is null.




入力パラメーターの場合、値はサーバーに送信される OracleCommand にバインドされます。For input parameters, the value is bound to the OracleCommand that is sent to the server. 出力と戻り値のパラメーターの場合、値は OracleCommand の完了時と OracleDataReader の終了後に設定されます。For output and return-value parameters, the value is set on completion of the OracleCommand and after the OracleDataReader is closed.

入力パラメーターの場合、Value は、Microsoft .NET Framework データ型または Oracle データ型 (たとえば、OracleNumberOracleString) のオブジェクトに設定できます。For an input parameter, Value can be set to an object of either a Microsoft .NET Framework data type or an Oracle data type (for example, an OracleNumber or OracleString).

サーバーに null パラメーター値を送信する場合、null ではなく DBNull を指定する必要があります。When you send a null parameter value to the server, you must specify DBNull, not null. システムの null 値は、値のない空のオブジェクトです。A null value in the system is an empty object that has no value. DBNull は、null 値を表すために使用されます。DBNull is used to represent null values.

アプリケーションでデータベースの種類を指定した場合、プロバイダーがデータをサーバーに送信するときに、バインドされた値がその型に変換されます。If the application specifies the database type, the bound value is converted to that type when the provider sends the data to the server. プロバイダーは、IConvertible インターフェイスをサポートしている場合、任意の型の値の変換を試みます。The provider tries to convert any type of value if it supports the IConvertible interface. 指定された型が値と互換性がない場合、変換エラーが発生する可能性があります。Conversion errors may result if the specified type is not compatible with the value.

パラメーターの DbTypeOracleType、および Size プロパティは、値を設定することによって推論できます。The DbType, OracleType, and Size properties of a parameter can be inferred by setting Value. そのため、指定する必要はありません。Therefore, you are not required to specify them. ただし、OracleParameter プロパティの設定では公開されません。However, they are not exposed in OracleParameter property settings. たとえば、パラメーターのサイズが推定されている場合、サイズにはステートメントの実行後の推定値は含まれません。For example, if the size of the parameter has been inferred, Size does not contain inferred value after statement execution.

値プロパティによって使用される InputOutputOutput、および ReturnValueParameterDirection 値は、入力値が Oracle データ型 (Microsoft .NET や OracleNumber など) でない限り、Framework データ型 OracleStringになります。The InputOutput, Output, and ReturnValueParameterDirection values used by the Value property will be Microsoft .NET Framework data types, unless the input value was an Oracle data type (for example, OracleNumber or OracleString). これは REF CURSOR、BFILE、または LOB データ型には適用されません。This does not apply to REF CURSOR, BFILE, or LOB data types.

Value プロパティは、 Updateメソッドによって上書きされます。The Value property is overwritten by the Update method.