SqlDataSource.OldValuesParameterFormatString Właściwość

Definicja

Pobiera lub ustawia ciąg formatu, który ma być stosowany do nazw wszystkich parametrów przekazywanych do Delete() metody or Update() .

public string OldValuesParameterFormatString { get; set; }

Wartość właściwości

Ciąg reprezentujący ciąg formatu zastosowany do nazw wszystkich oldValues parametrów przekazywanych do Delete() metod lub Update() . Wartość domyślna to "{0}".

Uwagi

Ciąg OldValuesParameterFormatString formatu jest stosowany tylko do kluczy podstawowych, takich jak te, które są identyfikowane przez DataKeyNames właściwość skojarzonej kontrolki powiązanej z danymi lub w scenariuszach usuwania i aktualizowania, w których ConflictDetection właściwość jest ustawiona na CompareAllValues wartość i zestaw oldValues są przekazywane do odpowiedniej metody danych. W takim przypadku ciąg formatu jest stosowany do każdej nazwy parametru w kolekcji oldValues .

Dwa typowe scenariusze, w których można zmienić OldValuesParameterFormatString właściwość, są następujące:

  • Aby rozróżnić stare i nowe wartości w aktualizacjach. ConflictDetection Gdy właściwość jest ustawiona CompareAllValues na wartość, parametry zarówno oryginalnych, jak i nowych wartości są dodawane do kolekcjiUpdateParameters. Bez ciągu formatowania dla każdego pola danych zostaną utworzone dwa parametry o tej samej nazwie. Zmieniając nazwę oryginalnego parametru wartości, można porównać dane z oryginalnym źródłem danych w celu wykrywania konfliktów i porównywania wartości kluczy.

  • Niektórzy projektanci wizualizacji implementują określony schemat nazewnictwa dla oryginalnych wartości i kluczy.

Dotyczy

Produkt Wersje
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też