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

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

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

SqlParameter.Value プロパティ

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

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

Visual Basic (宣言)

Public Overrides Property
 Value As Object

Visual Basic (使用法)

Dim instance As SqlParameter
Dim value As Object

value = instance.Value

instance.Value = value

public override Object Value { get; set;
 }

C++

public:
virtual property Object^ Value {
    Object^ get () override;
    void set (Object^ value) override;
}

/** @property */
public Object get_Value ()

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

JScript

public override function get
 Value () : Object

public override function set
 Value (value : Object)

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

解説

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

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

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

値を設定すると、DbType プロパティと SqlDbType プロパティの両方が推論できるようになります。

Value プロパティは、M.System.Data.SqlClient.SqlDataAdapter.UpdateCommand によって上書きされます。

使用例

SqlParameter を作成し、そのプロパティの一部を設定する例を次に示します。

Visual Basic

Private Sub CreateSqlParameterVersion()
    Dim parameter As New
 SqlParameter("Description", SqlDbType.VarChar, 88)
    parameter.Value = "garden hose"
End Sub

static void CreateSqlParameterVersion()
{
    SqlParameter parameter = new SqlParameter("Description",
 SqlDbType.VarChar, 88);
    parameter.Value = "garden hose";
}