SqlDataSource.OldValuesParameterFormatString Propiedad

Definición

Obtiene o establece una cadena de formato para aplicar a los nombres de cualquier parámetro que se pase al método Delete() o Update().Gets or sets a format string to apply to the names of any parameters that are passed to the Delete() or Update() method.

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 de propiedad

String

Una cadena que representa una cadena de formato aplicada a los nombres de cualquier parámetro oldValues pasado a los métodos Delete() o Update().A string that represents a format string applied to the names of any oldValues parameters passed to the Delete() or Update() methods. El valor predeterminado es "{0}".The default is "{0}".

Comentarios

La OldValuesParameterFormatString cadena de formato se aplica solo a las claves principales, como las que se identifican mediante la DataKeyNames propiedad del control enlazado a datos asociado, o en escenarios de eliminación y actualización en los que la ConflictDetection propiedad se establece en el CompareAllValues valor y un conjunto de oldValues se pasan al método de datos correspondiente.The OldValuesParameterFormatString format string is applied only to primary keys, such as those that are identified by the DataKeyNames property of the associated data-bound control, or in delete and update scenarios where the ConflictDetection property is set to the CompareAllValues value and a set of oldValues are passed to the corresponding data method. En este caso, la cadena de formato se aplica a cada nombre de parámetro de la oldValues colección.In this case, the format string is applied to each parameter name in the oldValues collection.

Dos escenarios comunes en los que se puede cambiar la OldValuesParameterFormatString propiedad son los siguientes:Two common scenarios where you might change the OldValuesParameterFormatString property are as follows:

  • Para diferenciar entre los valores antiguos y nuevos de las actualizaciones.To differentiate between old and new values in updates. Cuando la ConflictDetection propiedad se establece en el CompareAllValues valor, se agregan a la colección los parámetros de los valores originales y nuevos UpdateParameters .When the ConflictDetection property is set to the CompareAllValues value, parameters for both the original and new values are added to the UpdateParameters collection. Sin la cadena de formato, se crearán dos parámetros con el mismo nombre para cada campo de datos.Without the formatting string, two parameters with the same name would be created for each data field. Al cambiar el nombre del parámetro de valor original, puede comparar los datos con el origen de datos original para detectar conflictos y comparar los valores de clave.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.

  • Algunos diseñadores visuales implementan un esquema de nomenclatura determinado para las claves y los valores originales.Some visual designers implement a particular naming scheme for original values and keys.

Se aplica a

Consulte también