ObjectDataSource.OldValuesParameterFormatString ObjectDataSource.OldValuesParameterFormatString ObjectDataSource.OldValuesParameterFormatString ObjectDataSource.OldValuesParameterFormatString Property

Définition

Obtient ou définit une chaîne de format à appliquer aux noms des paramètres des valeurs d'origine qui sont passées aux méthodes Delete ou Update.Gets or sets a format string to apply to the names of the parameters for original values that are passed to the Delete or Update methods.

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 format appliquée aux noms de tout oldValues ou paramètre de clé passé aux méthodes Delete() ou Update().A string that represents a format string applied to the names of any oldValues or key parameters passed to the Delete() or Update() methods. La valeur par défaut est «{0}», ce qui signifie que le nom du paramètre est le nom du champ.The default is "{0}", which means the parameter name is the field name.

Remarques

La valeur de la OldValuesParameterFormatString propriété est appliquée uniquement aux clés primaires, telles que celles qui sont identifiées avec DataKeyNames la propriété d’un contrôle lié aux données, ou dans les scénarios de suppression et ConflictDetection de mise à jour où CompareAllValues la propriété a la valeur valeur, et l’ensemble de valeurs d’origine est passé à la méthode de données correspondante.The value of the OldValuesParameterFormatString property is applied to primary keys only, such as those that are identified with the DataKeyNames property of a data-bound control, or in delete and update scenarios where the ConflictDetection property is set to the CompareAllValues value, and the set of original values are passed to the corresponding data method.

Voici deux scénarios courants dans lesquels vous pouvez modifier la OldValuesParameterFormatString propriété:The following are two common scenarios where you might change the OldValuesParameterFormatString property:

  • Vous pouvez modifier la propriété pour faire la différence entre les anciennes et les nouvelles valeurs des mises à jour.You might want to change the property to differentiate between old and new values in updates. Lorsque la ConflictDetection propriété est définie sur la CompareAllValues valeur, les paramètres des valeurs d’origine et nouvelles sont ajoutés à la UpdateParameters collection.When the ConflictDetection property is set to the CompareAllValues value, parameters for both the original and new values are added to the 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.Without the formatting string, two parameters with the same name would be created for each data field. 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és.By changing the name of the original value parameter, you can compare the data to the original data source to detect conflicts and compare key values.

  • Certains concepteurs visuels implémentent un schéma d’affectation de noms particulier pour les valeurs et les clés d’origine.Some visual designers implement a particular naming scheme for original values and keys.

La OldValuesParameterFormatString propriété délègue à OldValuesParameterFormatString la propriété de ObjectDataSourceView l’objet associé au ObjectDataSource contrôle.The OldValuesParameterFormatString property delegates to the OldValuesParameterFormatString property of the ObjectDataSourceView object that is associated with the ObjectDataSource control.

S’applique à

Voir aussi