IDataParameter.Value プロパティ

  • リファレンス

定義

名前空間:
System.Data
アセンブリ:
System.Data.Common.dll
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll

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

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public object? Value { get; set; }
public object Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

プロパティ値

Object

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

例

次の例では、 実装クラス のインスタンスを作成し、 SqlParameterそのプロパティの一部を設定します。

public void CreateSqlParameter()
{
    SqlParameter parameter = new SqlParameter(
        "@Description", SqlDbType.VarChar);
    parameter.Value = "garden hose";
    parameter.Size = 11;
}

Public Sub CreateSqlParameter()
    Dim parameter As New SqlParameter( _
        "@Description", SqlDbType.VarChar)
    parameter.Value = "garden hose"
    parameter.Size = 11
End Sub

注釈

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

サーバーに null パラメーター値を送信する場合、ユーザーは null ではなく を指定 DBNullする必要があります。 システムの null 値は、値のない空オブジェクトです。 DBNull は、null 値を表すために使用します。

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

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

適用対象