IDataParameter.Value プロパティ

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

Property Value As Object
[C#]
object Value {get; set;}
[C++]
__property Object* get_Value();__property void set_Value(Object*);
[JScript]
function get Value() : Object;function set Value(Object);

プロパティ値

パラメータの値を示す Object 。既定値は null です。

解説

入力パラメータの場合、値はサーバーに送信される IDbCommand に連結されます。出力パラメータと戻り値パラメータの場合、値は IDbCommand の完了時と IDataReader の終了後に設定されます。

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

アプリケーションがデータベースの種類を指定する場合は、プロバイダがデータをサーバーに送信するときに、連結された値はその種類に変換されます。 IConvertible インターフェイスをサポートしている場合、プロバイダはすべての種類の値を変換しようとします。指定した型が値と互換性を持たない場合は、変換エラーが発生することがあります。

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

使用例

[Visual Basic, C#, C++] 実装クラスのインスタンス、 SqlParameter を作成し、そのプロパティの一部を設定する例を次に示します。

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

[C#] 
public void CreateSqlParameter() 
 {
    SqlParameter myParameter = new SqlParameter("@Description", SqlDbType.VarChar);
    myParameter.Value = "garden hose";
    myParameter.Size = 11;
 }

[C++] 
public:
void CreateSqlParameter() 
 {
    SqlParameter* myParameter = new SqlParameter(S"@Description", SqlDbType::VarChar);
    myParameter->Value = S"garden hose";
    myParameter->Size = 11;
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

IDataParameter インターフェイス | IDataParameter メンバ | System.Data 名前空間