SqlParameter.SqlValue プロパティ

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

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

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

[System.ComponentModel.Browsable(false)]
public object SqlValue { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SqlValue : obj with get, set

Public Property SqlValue As Object

プロパティ値

Object

SQL 型を使用する、パラメーターの値である Object。 既定値は、null です。

属性

BrowsableAttribute

注釈

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

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

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

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

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

SqlParameter.Value共通言語ランタイム (CLR) 型としてパラメーター値を返すには、 プロパティを使用します。

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