SqlDataSource.OldValuesParameterFormatString Propriété

Définition

Obtient ou définit une chaîne de mise en forme à appliquer aux noms de tous les paramètres qui sont passés à la méthode 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

Valeur de propriété

Une chaîne qui représente une chaîne de mise en forme appliquée aux noms de tous les paramètres oldValues passé aux méthodes Delete() ou Update(). La valeur par défaut est « {0} »

Remarques

La OldValuesParameterFormatString chaîne de format est appliquée uniquement aux clés primaires, telles que celles identifiées par la DataKeyNames propriété du contrôle lié aux données associé, ou dans les scénarios de suppression et de mise à jour où la ConflictDetection propriété est définie sur la CompareAllValues valeur et un jeu de sont passés à la méthode de oldValues données correspondante. Dans ce cas, la chaîne de format est appliquée à chaque nom de paramètre dans la oldValues collection.

Deux scénarios courants dans lesquels vous pouvez modifier la OldValuesParameterFormatString propriété sont les suivants :

  • Pour différencier les anciennes et les nouvelles valeurs dans les mises à jour. Lorsque la ConflictDetection propriété est définie sur la valeur , les CompareAllValues paramètres des valeurs d’origine et des nouvelles valeurs sont ajoutés à la UpdateParameters collection. Sans la chaîne de mise en forme, deux paramètres portant le même nom seraient créés pour chaque champ de données. En modifiant le nom du paramètre de valeur d’origine, vous pouvez comparer les données à la source de données d’origine pour détecter les conflits et comparer les valeurs de clé.

  • Certains concepteurs visuels implémentent un schéma de nommage particulier pour les valeurs et clés d’origine.

S’applique à

Voir aussi