ObjectDataSourceView.OldValuesParameterFormatString Свойство

Определение

Получает или задает строку формата, применяемую к именам параметров для исходных значений, передаваемых методу Delete или Update.Gets or sets a format string to apply to the names of the parameters for original values that are passed to the Delete or Update methods.

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

Строка, представляющая строку формата, применяемую к именам любых параметров oldValues, переданных методу Delete или Update.A string that represents a format string applied to the names of any oldValues passed to the Delete or Update method. Значение по умолчанию — " {0} ". Это означает, что имя параметра — это просто имя поля.The default is "{0}", which means the parameter name is simply the field name.

Комментарии

OldValuesParameterFormatStringСтрока формата применяется только к первичным ключам, например к тем, которые определены DataKeyNames свойством привязанного к данным элемента управления или в сценариях удаления и обновления, где ConflictDetection свойству присваивается CompareAllValues значение и набор исходных значений, передаваемых в соответствующий метод данных.The OldValuesParameterFormatString format string is applied to primary keys only, such as those that are identified with the DataKeyNames property of a data-bound control or in delete and update scenarios, where the ConflictDetection property is set to the CompareAllValues value and the set of original values that are passed to the corresponding data method.

Ниже приведены два распространенных сценария, в которых можно изменить OldValuesParameterFormatString свойство.Two common scenarios where you might change the OldValuesParameterFormatString property are as follows:

  • Для различения старых и новых значений в обновлениях.To differentiate between old and new values in updates. Если для ConflictDetection свойства задано CompareAllValues значение, то в коллекцию добавляются параметры для исходного и нового значений UpdateParameters .When the ConflictDetection property is set to the CompareAllValues value, parameters for both the original and new values are added to the UpdateParameters collection. Без строки форматирования для каждого поля данных будет создано два параметра с одинаковым именем.Without the formatting string, two parameters with the same name would be created for each data field. Изменяя имя исходного параметра значения, можно сравнить данные с исходным источником данных для обнаружения конфликтов и сравнения значений ключей.By changing the name of the original value parameter, you can compare the data to the original data source to detect conflicts and compare key values.

  • Некоторые визуальные конструкторы реализуют определенную схему именования для исходных значений и ключей.Some visual designers implement a particular naming scheme for original values and keys.

Значение параметра OldValuesParameterFormatString сохраняется в состоянии представления.The value of the OldValuesParameterFormatString is stored in view state.

Применяется к

См. также раздел