SqlParameter.Value プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
パラメーターの値を取得または設定します。
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; }public override object Value { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, setmember this.Value : obj with get, setPublic Overrides Property Value As Objectプロパティ値
パラメーターの値である Object。 既定値は、null です。
実装
- 属性
例
次の例では、 を 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」を参照してください。