SqlDataSource.OldValuesParameterFormatString プロパティ

定義

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

public:
 property System::String ^ OldValuesParameterFormatString { System::String ^ get(); void set(System::String ^ value); };
public string OldValuesParameterFormatString { get; set; }
member this.OldValuesParameterFormatString : string with get, set
Public Property OldValuesParameterFormatString As String

プロパティ値

Delete() メソッドまたは Update() メソッドに渡される任意の oldValues パラメーターの名前に適用される書式指定文字列を表す文字列。 既定値は "{0}" です。

注釈

書式指定文字列はOldValuesParameterFormatString、関連付けられたデータ バインド コントロールの プロパティでDataKeyNames識別される主キーや、プロパティが値に設定CompareAllValuesされ、 のセットoldValuesConflictDetection対応するデータ メソッドに渡される削除および更新のシナリオなど、主キーにのみ適用されます。 この場合、書式指定文字列はコレクション内の各パラメーター名に oldValues 適用されます。

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

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

  • 一部のビジュアル デザイナーは、元の値とキーに対して特定の名前付けスキームを実装します。

適用対象

こちらもご覧ください