次の方法で共有

SqlParameter.Value プロパティ

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll
ソース:
System.Data.SqlClient.notsupported.cs

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

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))]
[System.Data.DataSysDescription("DataParameter_Value")]
public object Value { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public override object Value { get; set; }
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
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
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 が閉じられた後に設定されます。

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

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

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

DbTypeプロパティとSqlDbTypeプロパティの両方を、Value を設定して推論できます。

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

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

適用対象

こちらもご覧ください