SqlParameter.Value プロパティ

  • リファレンス

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll
パッケージ:
System.Data.SqlClient v4.8.6

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

public:
 virtual property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Value : obj with get, set
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
[<System.Data.DataSysDescription("DataParameter_Value")>]
member this.Value : obj with get, set
Public Overrides Property Value As Object
Public Property Value As Object

プロパティ値

Object

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

実装

Value
属性
TypeConverterAttribute DataSysDescriptionAttribute

例

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

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

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

注釈

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

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

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

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

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

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

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

適用対象

こちらもご覧ください