IDataParameter.Value プロパティ

定義

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

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

プロパティ値

パラメーターの値である ObjectAn Object that is the value of the parameter. 既定値は NULL です。The default value is null.

次の例では、実装するクラスSqlParameterのインスタンスを作成し、そのプロパティの一部を設定します。The following example creates an instance of the implementing class, SqlParameter, and sets some of its properties.

public void CreateSqlParameter() 
{
    SqlParameter parameter = new SqlParameter(
        "@Description", SqlDbType.VarChar);
    parameter.Value = "garden hose";
    parameter.Size = 11;
}
Public Sub CreateSqlParameter()
    Dim parameter As New SqlParameter( _
        "@Description", SqlDbType.VarChar)
    parameter.Value = "garden hose"
    parameter.Size = 11
End Sub 

注釈

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

サーバーに null パラメーター値を送信する場合、ユーザーは null でDBNullはなくを指定する必要があります。When sending a null parameter value to the server, the user must specify DBNull, not null. システムの null 値は、値のない空オブジェクトです。The 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 attempts 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.

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

適用対象