IDataParameter.Value プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IDataParameter.Value プロパティ

パラメータの値を取得または設定します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Property Value As Object

Visual Basic (使用法)

Dim instance As IDataParameter
Dim value As Object

value = instance.Value

instance.Value = value

Object Value { get; set; }

C++

property Object^ Value {
    Object^ get ();
    void set (Object^ value);
}

/** @property */
Object get_Value ()

/** @property */
void set_Value (Object value)

JScript

function get Value () : Object

function set Value (value : Object)

プロパティ値
パラメータの値を示す Object。既定値は null です。

解説

入力パラメータでは、値は、サーバーに送信する IDbCommand に連結されます。出力パラメータと戻り値パラメータでは、値は、IDbCommand の完了時および IDataReader を閉じた後に設定されます。

null パラメータ値をサーバーに送信する場合は、null ではなく DBNull を指定する必要があります。システムの null 値は、値のない空のオブジェクトです。DBNull は、null 値を表すために使用します。

アプリケーションがデータベースの種類を指定する場合は、プロバイダがデータをサーバーに送信するときに、連結された値はその種類に変換されます。IConvertible インターフェイスをサポートしている場合、プロバイダはすべての種類の値を変換しようとします。指定した型が値と互換性を持たない場合は、変換エラーが発生することがあります。

Value プロパティは、Update によって上書きされます。

使用例

実装クラスのインスタンス、SqlParameter を作成し、そのプロパティの一部を設定する例を次に示します。

Visual Basic

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

public void CreateSqlParameter() 
{
    SqlParameter parameter = new SqlParameter(
        "@Description", SqlDbType.VarChar);
    parameter.Value = "garden hose";
    parameter.Size = 11;
}