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

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

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

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

De IDictionary las claves de objeto o fila que va a actualizar la operación de actualización.

values

IDictionary

de IDictionary pares nombre-valor que representan elementos de datos y sus nuevos valores.

oldValues

IDictionary

De IDictionary pares nombre-valor que representan elementos de datos y sus valores originales.

Devoluciones

Int32

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

Excepciones

NotSupportedException

La ExecuteUpdate(IDictionary, IDictionary, IDictionary) operación no es compatible con .DataSourceView

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 forma parte de un ejemplo más grande proporcionado para la DataSourceView clase .

// 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.

Consulte también

• CanUpdate