DataAdapter.Update(DataSet) Método

public:
 virtual int Update(System::Data::DataSet ^ dataSet);

public:
 abstract int Update(System::Data::DataSet ^ dataSet);

public virtual int Update (System.Data.DataSet dataSet);

public abstract int Update (System.Data.DataSet dataSet);

abstract member Update : System.Data.DataSet -> int
override this.Update : System.Data.DataSet -> int

abstract member Update : System.Data.DataSet -> int

Public Overridable Function Update (dataSet As DataSet) As Integer

Public MustOverride Function Update (dataSet As DataSet) As Integer

Parámetros

Devoluciones

Número de filas del DataSet actualizadas correctamente.

Implementaciones

Excepciones

Ejemplos

En el ejemplo siguiente se usa la clase derivada , OleDbDataAdapterpara Update el origen de datos.

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter adapter =
            new OleDbDataAdapter();
        adapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder =
            new OleDbCommandBuilder(adapter);

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

Public Function CreateCommandAndUpdate( _
    ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim adapter As New OleDbDataAdapter()

        adapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

Comentarios

La actualización se realiza por fila. Para cada fila insertada, modificada y eliminada, el Update método determina el tipo de cambio que se ha realizado en ella (Insertar, Actualizar o Eliminar). Según el tipo de cambio, la Insertplantilla de comando , Update, o Delete se ejecuta para propagar la fila modificada al origen de datos. Cuando una aplicación llama al Update método , DataAdapter examina la RowState propiedad y ejecuta las instrucciones INSERT, UPDATE o DELETE necesarias de forma iterativa para cada fila, en función del orden de los índices configurados en DataSet. Por ejemplo, Update podría ejecutar una instrucción DELETE, seguida de una instrucción INSERT y, a continuación, otra instrucción DELETE, debido al orden de las filas de DataTable.

Debe tenerse en cuenta que estas instrucciones no se realizan como un proceso por lotes; cada fila se actualiza individualmente. Una aplicación puede llamar al GetChanges método en situaciones en las que debe controlar la secuencia de tipos de instrucción (por ejemplo, INSERT antes de UPDATE). Para obtener más información, consulte Actualización de orígenes de datos con DataAdapters.

Si no se han especificado instrucciones INSERT, UPDATE o DELETE, el Update método genera una excepción. Sin embargo, puede crear un SqlCommandBuilder objeto o OleDbCommandBuilder para generar automáticamente instrucciones SQL para actualizaciones de tabla única si establece la SelectCommand propiedad de un proveedor de datos de .NET Framework. A continuación, las instrucciones SQL adicionales que no establezca se generan mediante CommandBuilder. Esta lógica de generación requiere que la información de columna de clave esté presente en .DataSet Para obtener más información, vea Generar comandos con CommandBuilders.

El Update método recupera filas de la tabla enumerada en la primera asignación antes de realizar una actualización. A Update continuación, actualiza la fila utilizando el valor de la UpdatedRowSource propiedad . Se omiten las filas adicionales devueltas.

Una vez cargados los datos en DataSet, se genera el OnRowUpdated evento , lo que permite al usuario inspeccionar la fila reconciliada DataSet y los parámetros de salida devueltos por el comando . Una vez que una fila se actualiza correctamente, se aceptan los cambios en esa fila.

Al usar Update, el orden de ejecución es el siguiente:

1. Los valores de DataRow se mueven a los valores de parámetro.

2. Se genera el evento OnRowUpdating.

3. El comando se ejecuta.

4. Si el comando se establece FirstReturnedRecorden , el primer resultado devuelto se coloca en .DataRow

5. Si hay parámetros de salida, se colocan en .DataRow

6. Se genera el evento OnRowUpdated.

7. Se llama a DataRow.AcceptChanges. Esto generará los DataTable.RowChanging eventos y DataTable.RowChanged para el actualizado DataRow.

Cada comando asociado a normalmente DataAdapter tiene una colección de parámetros asociada. Los parámetros se asignan a la fila actual a través de las SourceColumn propiedades y SourceVersion de la clase de Parameter un proveedor de datos de .NET. SourceColumn hace referencia a una DataTable columna que hace DataAdapter referencia a para obtener los valores de parámetro de la fila actual.

SourceColumn hace referencia al nombre de columna sin asignar antes de que se hayan aplicado asignaciones de tabla. Si SourceColumn hace referencia a una columna inexistente, la acción realizada depende de uno de los valores siguientes MissingMappingAction .

La SourceColumn propiedad también se usa para asignar el valor de los parámetros output o input/output a DataSet. Se genera una excepción si hace referencia a una columna inexistente.

La SourceVersion propiedad de la clase de Parameter un proveedor de datos de .NET determina si se debe usar la versión Original, Actual o Propuesta del valor de columna. Esta funcionalidad se suele usar para incluir valores originales en la cláusula WHERE de una instrucción UPDATE para comprobar si hay infracciones de simultaneidad optimista.

Al llamar al AcceptChanges método o AcceptChanges al método , se confirmarán todos los cambios en o DataSetDataTable. Si se llama a cualquiera de estos métodos antes de llamar al Update método , no se confirmarán cambios cuando se llame al Update método , a menos que se hayan realizado más cambios desde AcceptChanges o AcceptChanges se haya llamado a .

Se aplica a

Consulte también

• Información general de ADO.NET