SqlDataSource.OldValuesParameterFormatString プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

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

プロパティ値

String

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

注釈

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

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

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

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

こちらもご覧ください

• データ ソース Web サーバー コントロール
• SqlDataSource Web Server コントロールの概要