DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intProtected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerPará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
El objeto ExecuteUpdate(IDictionary, IDictionary, IDictionary) no admite la operación de 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 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.
