ObjectDataSource.OldValuesParameterFormatString Propriedade

Definição

Obtém ou define uma cadeia de caracteres de formato para aplicar aos nomes dos parâmetros para os valores originais que são passados para os métodos Delete ou 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

Valor da propriedade

String

Uma cadeia de caracteres que representa uma cadeia de caracteres de formato aplicada aos nomes de qualquer oldValues ou parâmetros chave passados para os métodos Delete() ou 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. O padrão é " {0} ", que significa que o nome do parâmetro é o nome do campo.The default is "{0}", which means the parameter name is the field name.

Comentários

O valor da OldValuesParameterFormatString propriedade é aplicado somente a chaves primárias, como as que são identificadas com a DataKeyNames propriedade de um controle vinculado a dados, ou em cenários de exclusão e atualização em que a ConflictDetection propriedade é definida como o CompareAllValues valor e o conjunto de valores originais é passado para o método de dados correspondente.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.

A seguir estão dois cenários comuns em que você pode alterar a OldValuesParameterFormatString Propriedade:The following are two common scenarios where you might change the OldValuesParameterFormatString property:

  • Talvez você queira alterar a propriedade para diferenciar os valores antigos e novos nas atualizações.You might want to change the property to differentiate between old and new values in updates. Quando a ConflictDetection propriedade é definida como o CompareAllValues valor, os parâmetros para os valores original e novo são adicionados à UpdateParameters coleção.When the ConflictDetection property is set to the CompareAllValues value, parameters for both the original and new values are added to the UpdateParameters collection. Sem a cadeia de caracteres de formatação, dois parâmetros com o mesmo nome seriam criados para cada campo de dados.Without the formatting string, two parameters with the same name would be created for each data field. Ao alterar o nome do parâmetro de valor original, você pode comparar os dados com a fonte de dados original para detectar conflitos e comparar valores de chave.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.

  • Alguns designers visuais implementam um esquema de nomenclatura específico para valores e chaves originais.Some visual designers implement a particular naming scheme for original values and keys.

A OldValuesParameterFormatString propriedade é delegada à OldValuesParameterFormatString Propriedade do ObjectDataSourceView objeto que está associado ao ObjectDataSource controle.The OldValuesParameterFormatString property delegates to the OldValuesParameterFormatString property of the ObjectDataSourceView object that is associated with the ObjectDataSource control.

Aplica-se a

Confira também