ObjectDataSourceView.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 passado para o Delete método ou Update . O padrão é "{0}", o que significa que o nome do parâmetro é simplesmente o nome do campo.

Comentários

A OldValuesParameterFormatString cadeia de caracteres de formato é aplicada 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 que são passados para o método de dados correspondente.

Dois cenários comuns em que você pode alterar a propriedade são os OldValuesParameterFormatString seguintes:

  • Para diferenciar 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.

O valor do OldValuesParameterFormatString é armazenado no estado de exibição.

Aplica-se a

Confira também