Compartilhar via


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.

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

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(). O padrão é "{0}", o que significa que o nome do parâmetro é o nome do campo.

Comentários

O valor da OldValuesParameterFormatString propriedade é aplicado somente a chaves primárias, como aquelas identificadas com a DataKeyNames propriedade de um controle associado 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.

Veja a seguir dois cenários comuns em que você pode alterar a OldValuesParameterFormatString propriedade :

  • Talvez você queira alterar a propriedade para diferenciar entre valores antigos e novos em atualizações. Quando a ConflictDetection propriedade é definida como o CompareAllValues valor, os parâmetros para os valores original e novo são adicionados à UpdateParameters coleção. Sem a cadeia de caracteres de formatação, dois parâmetros com o mesmo nome seriam criados para cada campo de dados. 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.

  • Alguns designers visuais implementam um esquema de nomenclatura específico para valores e chaves originais.

A OldValuesParameterFormatString propriedade delega à OldValuesParameterFormatString propriedade do ObjectDataSourceView objeto associado ao ObjectDataSource controle .

Aplica-se a

Confira também