IDataParameter.SourceVersion プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IDataParameter.SourceVersion プロパティ

Value の読み込み時に使用する DataRowVersion を取得または設定します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Property SourceVersion As DataRowVersion

Visual Basic (使用法)

Dim instance As IDataParameter
Dim value As DataRowVersion

value = instance.SourceVersion

instance.SourceVersion = value

DataRowVersion SourceVersion { get; set; }

C++

property DataRowVersion SourceVersion {
    DataRowVersion get ();
    void set (DataRowVersion value);
}

/** @property */
DataRowVersion get_SourceVersion ()

/** @property */
void set_SourceVersion (DataRowVersion value)

JScript

function get SourceVersion () : DataRowVersion

function set SourceVersion (value : DataRowVersion)

プロパティ値
DataRowVersion 値の 1 つ。既定値は Current です。

例外

例外の種類	条件
ArgumentException	プロパティが DataRowVersion 値の 1 つに設定されていません。

解説

Update 操作中に、UpdateCommand は、このプロパティを使用して、パラメータ値が元の値と現在の値のどちらに設定されているかを判断します。これにより、主キーを更新できます。このプロパティは InsertCommand と DeleteCommand では無視されます。このプロパティは、Item プロパティ、または DataRow オブジェクトの GetChildRows メソッドが使用する、DataRow のバージョンに設定されます。

使用例

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

Visual Basic

Public Sub CreateSqlParameter()
    Dim parameter As New
 SqlParameter( _
        "@Description", SqlDbType.VarChar)
    parameter.IsNullable = True
    parameter.SourceColumn = "Description"
    parameter.SourceVersion = DataRowVersion.Current
    parameter.Direction = ParameterDirection.Output
End Sub

public void CreateSqlParameter() 
{
    SqlParameter parameter = new SqlParameter(
        "@Description", SqlDbType.VarChar);
    parameter.IsNullable = true;
    parameter.SourceColumn = "Description";
    parameter.SourceVersion = DataRowVersion.Current;
    parameter.Direction = ParameterDirection.Output;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition