Partager via

SqlDataSource.OldValuesParameterFormatString Propriété

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une chaîne de format à appliquer aux noms des paramètres passés à la ou Update() à la Delete() méthode.

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é

String

Chaîne qui représente une chaîne de format appliquée aux noms des oldValues paramètres passés aux méthodes ou Update() aux Delete() méthodes. 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ées, 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 ensemble de données 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 de la oldValues collection.

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

  • Pour différencier les anciennes et nouvelles valeurs dans les mises à jour. Lorsque la ConflictDetection propriété est définie sur la CompareAllValues valeur, les paramètres des valeurs d’origine et de nouvelles valeurs sont ajoutés à la UpdateParameters collection. Sans la chaîne de mise en forme, deux paramètres portant le même nom sont 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 d’affectation de noms particulier pour les valeurs et clés d’origine.

S’applique à

Voir aussi