ObjectDataSource.OldValuesParameterFormatString Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.