ObjectDataSource.OldValuesParameterFormatString Propriedade

Definição

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

Uma cadeia que representa uma cadeia de formato aplicada aos nomes de quaisquer oldValues ou parâmetros-chave passados aos Delete() métodos ou Update() . O padrão é "{0}", o que significa que o nome do parâmetro é o nome do campo.

Observações

O valor da OldValuesParameterFormatString propriedade é aplicado apenas a chaves primárias, como aquelas identificadas com a DataKeyNames propriedade de um controlo ligado a dados, ou em cenários de exclusão e atualização onde a ConflictDetection propriedade é definida para o CompareAllValues valor e o conjunto de valores originais é passado para o método de dados correspondente.

Seguem-se dois cenários comuns em que pode alterar a OldValuesParameterFormatString propriedade:

  • Pode querer alterar a propriedade para diferenciar entre valores antigos e novos nas atualizações. Quando a ConflictDetection propriedade é definida para esse CompareAllValues valor, são adicionados parâmetros para ambos os valores originais e novos à UpdateParameters coleção. Sem a cadeia 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, pode comparar os dados com a fonte original para detetar conflitos e comparar valores-chave.

  • Alguns designers visuais implementam um esquema de nomenclatura particular para valores e chaves originais.

A OldValuesParameterFormatString propriedade delega à OldValuesParameterFormatString propriedade do ObjectDataSourceView objeto associada ao ObjectDataSource controlo.

Aplica-se a

Ver também