ObjectDataSource.OldValuesParameterFormatString Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 .