SqlDataSource.OldValuesParameterFormatString Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

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().

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(). El valor predeterminado es "{0}".

Comentarios

La OldValuesParameterFormatString cadena de formato solo se aplica a las claves principales, como las identificadas por 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 se pasan al método de oldValues datos correspondiente. En este caso, la cadena de formato se aplica a cada nombre de parámetro de la oldValues colección.

Dos escenarios comunes en los que podría cambiar la OldValuesParameterFormatString propiedad son los siguientes:

  • Para diferenciar entre los valores antiguos y los nuevos de las actualizaciones. Cuando la ConflictDetection propiedad se establece en el CompareAllValues valor, los parámetros de los valores originales y nuevos se agregan a la UpdateParameters colección. Sin la cadena de formato, se crearían dos parámetros con el mismo nombre para cada campo de datos. 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 valores de clave.

  • Algunos diseñadores visuales implementan un esquema de nomenclatura determinado para valores y claves originales.

Se aplica a

Consulte también