DbDataAdapter.Update Método

Definición

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en DataSet.

Sobrecargas

Update(DataSet, String)

Actualiza los valores de la base de datos al ejecutar las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet con el nombre de DataTable especificado.

Update(DataRow[], DataTableMapping)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz de objetos DataRow especificada.

Update(DataTable)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataTable especificados.

Update(DataSet)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet especificados.

Update(DataRow[])

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz especificada en DataSet.

Update(DataSet, String)

Actualiza los valores de la base de datos al ejecutar las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet con el nombre de DataTable especificado.

public:
 int Update(System::Data::DataSet ^ dataSet, System::String ^ srcTable);
public int Update (System.Data.DataSet dataSet, string srcTable);
override this.Update : System.Data.DataSet * string -> int
Public Function Update (dataSet As DataSet, srcTable As String) As Integer

Parámetros

dataSet
DataSet

DataSet que se va a utilizar para actualizar el origen de datos.

srcTable
String

Nombre de la tabla de origen que se utilizará para la asignación de tabla.

Devoluciones

Int32

Número de filas del DataSet actualizadas correctamente.

Excepciones

La tabla de origen no es válida.

El hecho de intentar ejecutar una instrucción INSERT, UPDATE o DELETE no ha afectado a ningún registro.

Ejemplos

En el ejemplo siguiente se usa la clase derivada , OleDbDataAdapter, para actualizar el origen de datos.

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString, string tableName)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers, tableName);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String, _
    ByVal tableName As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers, tableName)

        Return customers
    End Using
End Function

Comentarios

Cuando una aplicación llama al Update método , DbDataAdapter 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 las actualizaciones de una sola tabla si establece la SelectCommand propiedad de un proveedor de datos .NET Framework. A continuación, el CommandBuilder genera cualquier instrucción SQL adicional que no establezca. 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 admite escenarios en los DataSet que contiene varios DataTable objetos cuyos nombres solo difieren por mayúsculas y minúsculas. Cuando varias tablas con el mismo nombre, pero mayúsculas y minúsculas diferentes, existen en , DataSetUpdate realiza una comparación que distingue mayúsculas de minúsculas para buscar la tabla correspondiente y genera una excepción si no existe ninguna coincidencia exacta. El código de C# siguiente muestra este comportamiento.

DataSet ds = new DataSet();  
 ds.Tables.Add("aaa");  
 ds.Tables.Add("AAA");  
 adapter.Update(ds, "aaa"); // Updates "aaa", which already exists in the DataSet.  
 adapter.Update(ds, "AAA"); // Updates "AAA", which already exists in the DataSet.  
    adapter.Update(ds, "Aaa"); // Results in an exception.  

Si Update se llama a y DataSet contiene solo uno DataTable cuyo nombre difiere solo por mayúsculas y minúsculas, se DataTable actualiza. En este escenario, la comparación no distingue mayúsculas de minúsculas. El código de C# siguiente muestra este comportamiento.

DataSet dataset = new DataSet();  
 dataset.Tables.Add("aaa");  
    adapter.Update(dataset, "AAA"); // Updates table "aaa" because only one similarly named table is in the DataSet.  

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 con el valor de la UpdatedRowSource propiedad . Se omiten las filas adicionales devueltas.

Una vez que se vuelven a cargar 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. Después de que una fila se actualice correctamente, se aceptan los cambios en esa fila.

Cuando se usa 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 AcceptChanges.

Cada comando asociado a DbDataAdapter normalmente 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 una clase del Parameter proveedor de datos de .NET Framework. SourceColumn hace referencia a una DataTable columna que hace DbDataAdapter 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 .

Valor de enumeración Acción realizada
MissingMappingAction.Passthrough Use los nombres de columna de origen y los nombres de tabla en DataSet si no hay ninguna asignación presente.
MissingMappingAction.Ignore Se genera un SystemException . Cuando las asignaciones se establecen explícitamente, una asignación que falta para un parámetro de entrada suele ser el resultado de un error.
MissingMappingAction.Error Se genera un SystemException .

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 una .NET Framework clase del Parameter proveedor de datos 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.

Nota

Si se produce un error al actualizar una fila, se produce una excepción y se interrumpe la ejecución de la actualización. Para continuar con la operación de actualización sin generar excepciones cuando se encuentra un error, establezca la ContinueUpdateOnError propiedad true en antes de llamar a Update. También puede responder a errores por fila dentro del RowUpdated evento de dataAdapter. Para continuar con la operación de actualización sin generar una excepción dentro del RowUpdated evento, establezca la Status propiedad de en ContinueRowUpdatedEventArgs .

Consulte también

Se aplica a

Update(DataRow[], DataTableMapping)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz de objetos DataRow especificada.

protected:
 virtual int Update(cli::array <System::Data::DataRow ^> ^ dataRows, System::Data::Common::DataTableMapping ^ tableMapping);
protected virtual int Update (System.Data.DataRow[] dataRows, System.Data.Common.DataTableMapping tableMapping);
override this.Update : System.Data.DataRow[] * System.Data.Common.DataTableMapping -> int
Protected Overridable Function Update (dataRows As DataRow(), tableMapping As DataTableMapping) As Integer

Parámetros

dataRows
DataRow[]

Matriz de objetos DataRow utilizada para actualizar el origen de datos.

tableMapping
DataTableMapping

Colección TableMappings que se va a utilizar.

Devoluciones

Int32

Número de filas actualizadas correctamente a partir de la matriz de DataRow objetos .

Excepciones

La tabla de origen no es válida.

No existe ningún objeto DataRow que actualizar.

O bien No existe ningún objeto DataTable que actualizar.

O bien No existe ninguna clase DataSet que se vaya a utilizar como origen.

El hecho de intentar ejecutar una instrucción INSERT, UPDATE o DELETE no ha afectado a ningún registro.

Comentarios

Cuando una aplicación llama al Update método , DbDataAdapter 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 UPDAT). 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 las actualizaciones de una sola tabla si establece la SelectCommand propiedad de un proveedor de datos .NET Framework. A continuación, el CommandBuilder genera cualquier instrucción SQL adicional que no establezca. 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 AcceptChanges.

Cada comando asociado a normalmente DbDataAdapter 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 una clase del Parameter proveedor de datos de .NET Framework. SourceColumn hace referencia a una DataTable columna que hace DbDataAdapter 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 .

Valor de enumeración Acción realizada
MissingMappingAction.Passthrough Use los nombres de columna de origen y los nombres de tabla en DataSet si no hay ninguna asignación presente.
MissingMappingAction.Ignore SystemException Se genera un . Cuando las asignaciones se establecen explícitamente, una asignación que falta para un parámetro de entrada suele ser el resultado de un error.
MissingMappingAction.Error SystemException Se genera un .

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 una .NET Framework clase del Parameter proveedor de datos 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.

Nota

Si se produce un error al actualizar una fila, se produce una excepción y se interrumpe la ejecución de la actualización. Para continuar con la operación de actualización sin generar excepciones cuando se encuentra un error, establezca la ContinueUpdateOnError propiedad true en antes de llamar a Update. También puede responder a errores por fila dentro del RowUpdated evento de dataAdapter. Para continuar con la operación de actualización sin generar una excepción dentro del RowUpdated evento, establezca la Status propiedad de en ContinueRowUpdatedEventArgs .

Consulte también

Se aplica a

Update(DataTable)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataTable especificados.

public:
 int Update(System::Data::DataTable ^ dataTable);
public int Update (System.Data.DataTable dataTable);
override this.Update : System.Data.DataTable -> int
Public Function Update (dataTable As DataTable) As Integer

Parámetros

dataTable
DataTable

Clase DataTable que se utiliza para actualizar el origen de datos.

Devoluciones

Int32

Número de filas del DataTable actualizadas correctamente.

Excepciones

La tabla de origen no es válida.

No existe ningún objeto DataRow que actualizar.

O bien No existe ningún objeto DataTable que actualizar.

O bien No existe ninguna clase DataSet que se vaya a utilizar como origen.

El hecho de intentar ejecutar una instrucción INSERT, UPDATE o DELETE no ha afectado a ningún registro.

Ejemplos

En el ejemplo siguiente se usa la clase derivada , OleDbDataAdapter, para actualizar el origen de datos.

public DataTable CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataTable customers = new DataTable();
        adapter.Fill(customers);

        // code to modify data in DataTable here

        adapter.Update(customers);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataTable

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataTable()
        adapter.Fill(customers)

        ' Code to modify data in DataTable here 

        adapter.Update(customers)
        Return customers
    End Using
End Function

Comentarios

Cuando una aplicación llama al Update método , DbDataAdapter 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 UPDAT). 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 las actualizaciones de una sola tabla si establece la SelectCommand propiedad de un proveedor de datos .NET Framework. A continuación, el CommandBuilder genera cualquier instrucción SQL adicional que no establezca. 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 AcceptChanges.

Cada comando asociado a normalmente DbDataAdapter 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 una clase del Parameter proveedor de datos de .NET Framework. SourceColumn hace referencia a una DataTable columna que hace DbDataAdapter 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 .

Valor de enumeración Acción realizada
MissingMappingAction.Passthrough Use los nombres de columna de origen y los nombres de tabla en DataSet si no hay ninguna asignación presente.
MissingMappingAction.Ignore SystemException Se genera un . Cuando las asignaciones se establecen explícitamente, una asignación que falta para un parámetro de entrada suele ser el resultado de un error.
MissingMappingAction.Error SystemException Se genera un .

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 una .NET Framework clase del Parameter proveedor de datos 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.

Nota

Si se produce un error al actualizar una fila, se produce una excepción y se interrumpe la ejecución de la actualización. Para continuar con la operación de actualización sin generar excepciones cuando se encuentra un error, establezca la ContinueUpdateOnError propiedad true en antes de llamar a Update. También puede responder a errores por fila dentro del RowUpdated evento de dataAdapter. Para continuar con la operación de actualización sin generar una excepción dentro del RowUpdated evento, establezca la Status propiedad de en ContinueRowUpdatedEventArgs .

Consulte también

Se aplica a

Update(DataSet)

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en los objetos DataSet especificados.

public:
 override int Update(System::Data::DataSet ^ dataSet);
public override int Update (System.Data.DataSet dataSet);
override this.Update : System.Data.DataSet -> int
Public Overrides Function Update (dataSet As DataSet) As Integer

Parámetros

dataSet
DataSet

Clase DataSet que se utiliza para actualizar el origen de datos.

Devoluciones

Int32

Número de filas del DataSet actualizadas correctamente.

Implementaciones

Excepciones

La tabla de origen no es válida.

El hecho de intentar ejecutar una instrucción INSERT, UPDATE o DELETE no ha afectado a ningún registro.

Ejemplos

En el ejemplo siguiente se usa la clase derivada , OleDbDataAdapter, para actualizar el origen de datos.

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers)

        Return customers
    End Using
End Function

Comentarios

Cuando una aplicación llama al Update método , DbDataAdapter 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 UPDAT). 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 las actualizaciones de una sola tabla si establece la SelectCommand propiedad de un proveedor de datos .NET Framework. A continuación, el CommandBuilder genera cualquier instrucción SQL adicional que no establezca. 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 AcceptChanges.

Cada comando asociado a normalmente DbDataAdapter 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 una clase del Parameter proveedor de datos de .NET Framework. SourceColumn hace referencia a una DataTable columna que hace DbDataAdapter 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 .

Valor de enumeración Acción realizada
MissingMappingAction.Passthrough Use los nombres de columna de origen y los nombres de tabla en DataSet si no hay ninguna asignación presente.
MissingMappingAction.Ignore SystemException Se genera un . Cuando las asignaciones se establecen explícitamente, una asignación que falta para un parámetro de entrada suele ser el resultado de un error.
MissingMappingAction.Error SystemException Se genera un .

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 una .NET Framework clase del Parameter proveedor de datos 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.

Nota

Si se produce un error al actualizar una fila, se produce una excepción y se interrumpe la ejecución de la actualización. Para continuar con la operación de actualización sin generar excepciones cuando se encuentra un error, establezca la ContinueUpdateOnError propiedad true en antes de llamar a Update. También puede responder a errores por fila dentro del RowUpdated evento de dataAdapter. Para continuar con la operación de actualización sin generar una excepción dentro del RowUpdated evento, establezca la Status propiedad de en ContinueRowUpdatedEventArgs .

Consulte también

Se aplica a

Update(DataRow[])

Actualiza los valores de la base de datos ejecutando las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en la matriz especificada en DataSet.

public:
 int Update(cli::array <System::Data::DataRow ^> ^ dataRows);
public int Update (System.Data.DataRow[] dataRows);
override this.Update : System.Data.DataRow[] -> int
Public Function Update (dataRows As DataRow()) As Integer

Parámetros

dataRows
DataRow[]

Matriz de objetos DataRow utilizada para actualizar el origen de datos.

Devoluciones

Int32

Número de filas del DataSet actualizadas correctamente.

Excepciones

La tabla de origen no es válida.

No existe ningún objeto DataRow que actualizar.

O bien No existe ningún objeto DataTable que actualizar.

O bien No existe ninguna clase DataSet que se vaya a utilizar como origen.

El hecho de intentar ejecutar una instrucción INSERT, UPDATE o DELETE no ha afectado a ningún registro.

Ejemplos

En el ejemplo siguiente se usa la clase derivada , OleDbDataAdapter, para actualizar el origen de datos.

public DataSet CreateCmdsAndUpdate(string connectionString,
    string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        //Insert new records from DataSet
        DataRow[] rows = customers.Tables[0].Select(
            null, null, DataViewRowState.Added);
        adapter.Update(rows);

        return customers;
    }
}
Public Function CreateCmdsAndUpdate(ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As New DataSet()
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        ' Insert new records from DataSet
        Dim rows() As DataRow = customers.Tables(0).Select( _
            Nothing, Nothing, DataViewRowState.Added)
        adapter.Update(rows)

        Return customers
    End Using
End Function

Comentarios

Cuando una aplicación llama al Update método , DbDataAdapter 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 instrucciones (por ejemplo, INSERT antes de UPDATEs). 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, el CommandBuilder genera cualquier instrucción SQL adicional que no establezca. 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 con el valor de la UpdatedRowSource propiedad . Se omiten las filas adicionales devueltas.

Una vez que se vuelven a cargar 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. Después de que una fila se actualice correctamente, se aceptan los cambios en esa fila.

Cuando se usa 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 AcceptChanges.

Cada comando asociado a DbDataAdapter normalmente 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 una clase del Parameter proveedor de datos de .NET Framework. SourceColumn hace referencia a una DataTable columna que hace DbDataAdapter 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 .

Valor de enumeración Acción realizada
MissingMappingAction.Passthrough Use los nombres de columna de origen y los nombres de tabla en DataSet si no hay ninguna asignación presente.
MissingMappingAction.Ignore Se genera un SystemException . Cuando las asignaciones se establecen explícitamente, una asignación que falta para un parámetro de entrada suele ser el resultado de un error.
MissingMappingAction.Error Se genera un SystemException .

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 una .NET Framework clase del Parameter proveedor de datos 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.

Nota

Si se produce un error al actualizar una fila, se produce una excepción y se interrumpe la ejecución de la actualización. Para continuar con la operación de actualización sin generar excepciones cuando se encuentra un error, establezca la ContinueUpdateOnError propiedad true en antes de llamar a Update. También puede responder a errores por fila dentro del RowUpdated evento de dataAdapter. Para continuar con la operación de actualización sin generar una excepción dentro del RowUpdated evento, establezca la Status propiedad de en ContinueRowUpdatedEventArgs .

Consulte también

Se aplica a