Compartir a través de


DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Método

Definición

Realiza una operación de actualización en la lista de datos que el objeto DataSourceView representa.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parámetros

keys
IDictionary

Interfaz IDictionary de claves de objetos o filas que se va a actualizar mediante la operación de actualización.

values
IDictionary

Interfaz IDictionary de pares de nombre/valor que representan los elementos de datos y sus valores nuevos.

oldValues
IDictionary

Interfaz IDictionary de pares de nombre/valor que representan los elementos de datos y sus valores originales.

Devoluciones

Número de elementos que se actualizaron en el espacio de almacenamiento de datos subyacente.

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo una clase que extiende la DataSourceView clase puede invalidar la CanUpdate propiedad y el ExecuteUpdate método . Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase DataSourceView.

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}
   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Comentarios

Los controles enlazados a datos pueden determinar si una ExecuteUpdate operación es compatible con un control de origen de datos mediante el DataSourceControl.GetView método para recuperar el DataSourceView objeto y comprobar el valor de la CanUpdate propiedad.

El keys parámetro representa las claves de objeto o fila de los datos que se van a actualizar. Para los orígenes de datos que representan datos relacionales, como el SqlDataSource control , el keys parámetro es una colección de claves principales de base de datos. En otros escenarios, el keys parámetro es una colección de pares nombre-valor y se usa para filtrar una lista de datos. Los datos que coincidan con un par nombre-valor se actualizan con los valores encontrados en el values parámetro , que es un conjunto de pares nombre-valor que representa nuevos valores para los campos o columnas existentes.

Nota:

La implementación predeterminada de la DataSourceView clase es iniciar una NotSupportedException excepción. Si extiende la DataSourceView clase, invalide el ExecuteUpdate método si la clase admite la actualización de datos en el almacenamiento de datos subyacente.

Se aplica a

Consulte también