Share via


SqlDataSource.OldValuesParameterFormatString Propriedade

Definição

Obtém ou define uma cadeia de caracteres de formato para ser aplicada aos nomes dos parâmetros que são passados para o método 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

String

Uma cadeia de caracteres que representa uma cadeia de caracteres de formato aplicada aos nomes dos parâmetros oldValues passados para os métodos Delete() ou Update(). O padrão é "{0}".

Comentários

A OldValuesParameterFormatString cadeia de caracteres de formato é aplicada somente a chaves primárias, como aquelas identificadas pela DataKeyNames propriedade do 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 um conjunto de são passados para o método de oldValues dados correspondente. Nesse caso, a cadeia de caracteres de formato é aplicada a cada nome de parâmetro na oldValues coleção.

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

  • 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 originais e novos 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. Alterando 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.

Aplica-se a

Confira também