SqlParameter.Value プロパティ

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

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

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

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set

Public Overrides Property Value As Object

プロパティ値

Object

パラメーターの値である Object。 既定値は、null です。

実装

Value

属性

TypeConverterAttribute

例

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

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

注釈

入力パラメーターの場合、値はサーバーに送信される SqlCommand にバインドされます。 出力パラメーターおよび戻り値パラメーターの場合、値は SqlCommand が完了して SqlDataReader が閉じられた後に設定されます。

このプロパティは、 または DBNull.Valueにnull設定できます。 パラメーターの値として NULL 値を送信するには、 を使用 DBNull.Value します。 nullパラメーターの既定値を使用するには、 または を設定Valueしないでください。

Unicode 以外の XML データが文字列として渡されると、例外がスローされます。

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

DbTypeプロパティと SqlDbType プロパティの両方を推論する場合は、 Value を設定します。

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

ストリーミングの詳細については、「 SqlClient Streaming Support」を参照してください。