ObjectDataSourceView.OldValuesParameterFormatString プロパティ

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

ObjectDataSourceView.OldValuesParameterFormatString プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

Delete メソッドまたは Update メソッドに渡される元の値のパラメータ名に適用される書式指定文字列を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property OldValuesParameterFormatString
 As String

Visual Basic (使用法)

Dim instance As ObjectDataSourceView
Dim value As String

value = instance.OldValuesParameterFormatString

instance.OldValuesParameterFormatString = value

C#

public string OldValuesParameterFormatString
 { get; set; }

C++

public:
property String^ OldValuesParameterFormatString {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_OldValuesParameterFormatString ()

/** @property */
public void set_OldValuesParameterFormatString
 (String value)

JScript

public function get OldValuesParameterFormatString
 () : String

public function set OldValuesParameterFormatString
 (value : String)

プロパティ値
Delete メソッドまたは Update メソッドに渡される任意の oldValues の名前に適用される書式指定文字列を表す文字列。既定値は "{0}" です。パラメータ名が単にフィールド名であることを示します。

解説

OldValuesParameterFormatString 書式指定文字列は、データ バインド コントロールの DataKeyNames プロパティによって識別されるキーなどの主キー、または ConflictDetection プロパティが CompareAllValues 値、および対応するデータ メソッドに渡される元の値のセットに設定される削除と更新の場合に適用されます。

OldValuesParameterFormatString プロパティを変更する可能性がある 2 つの一般的なシナリオを次に示します。

• 更新で新旧の値を区別する場合。ConflictDetection プロパティが CompareAllValues 値に設定されている場合、元の値と新しい値の両方のパラメータが UpdateParameters コレクションに追加されます。書式指定文字列が指定されない場合、各データ フィールドに同じ名前の 2 つのパラメータが作成されます。元の値のパラメータ名を変更することで、データを元のデータ ソースと比較し、競合を検出してキー値を比較できます。

• いくつかのビジュアルなデザイナが元の値とキーに対する特定の名前付けスキームを実装する場合。

OldValuesParameterFormatString の値はビューステートに格納されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ObjectDataSourceView クラス
ObjectDataSourceView メンバ
System.Web.UI.WebControls 名前空間
ObjectDataSourceView.ConflictDetection プロパティ
ExecuteDelete
ExecuteUpdate