ObjectDataSource.OldValuesParameterFormatString プロパティ

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

ObjectDataSource.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 ObjectDataSource
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 パラメータまたは key パラメータの名前に適用される書式指定文字列を表す文字列。既定値は "{0}" です。これは、パラメータ名がフィールド名であることを示します。

解説

OldValuesParameterFormatString プロパティの値は、主キー (データ バインド コントロールの DataKeyNames プロパティで識別されるキーなど) にだけ適用されます。または、ConflictDetection プロパティが CompareAllValues 値および対応するデータ メソッドに渡される元の値のセットに設定されている削除および更新のシナリオで適用されます。

OldValuesParameterFormatString プロパティを変更する可能性のある 2 つの一般的なシナリオは次のとおりです。

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

• 一部のビジュアルなデザイナが元の値とキーの特定の名前付けスキームを実装している場合。

OldValuesParameterFormatString プロパティは、ObjectDataSource コントロールに関連付けられた ObjectDataSourceView オブジェクトの 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

参照

関連項目
ObjectDataSource クラス
ObjectDataSource メンバ
System.Web.UI.WebControls 名前空間
ObjectDataSource.ConflictDetection プロパティ
その他の技術情報
ObjectDataSource コントロールの概要