ObjectDataSource.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 or key parameters passed to the Delete() or Update() methods. Значение по умолчанию — " {0} ". Это означает, что имя параметра является именем поля.The default is "{0}", which means the parameter name is the field name.

Комментарии

Значение OldValuesParameterFormatString свойства применяется только к первичным ключам, например к тем, которые определяются DataKeyNames свойством элемента управления с привязкой к данным, или в сценариях удаления и обновления, где ConflictDetection свойству присвоено CompareAllValues значение, а набор исходных значений передается соответствующему методу данных.The value of the OldValuesParameterFormatString property 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 are passed to the corresponding data method.

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

  • Может потребоваться изменить свойство, чтобы отличать старые и новые значения в обновлениях.You might want to change the property 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Свойство делегирует OldValuesParameterFormatString свойство ObjectDataSourceView объекта, связанного с ObjectDataSource элементом управления.The OldValuesParameterFormatString property delegates to the OldValuesParameterFormatString property of the ObjectDataSourceView object that is associated with the ObjectDataSource control.

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

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