IDataAdapter.Update(DataSet) Método

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

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

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

Public Function Update (dataSet As DataSet) As Integer

Parámetros

Devoluciones

Número de filas del DataSet actualizadas correctamente.

Excepciones

Ejemplos

En el ejemplo siguiente se usa la clase derivada , OleDbDataAdapteren Update el origen de datos. En este ejemplo se supone que ha creado y OleDbDataAdapter .DataSet

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

Cuando una aplicación llama al Update método , IDataAdapter 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 a la ordenación de las filas de DataTable.

Tenga 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 si debe controlar la secuencia de tipos de instrucción (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 mediante 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 IDataAdapter normalmente tiene asociada una colección de parámetros. Los parámetros se asignan a la fila actual a través de las SourceColumn propiedades y SourceVersion de la clase de un proveedor de datos de Parameter .NET Framework. SourceColumn hace referencia a una DataTable columna que hace IDataAdapter 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 una clase del proveedor de datos de Parameter .NET Framework determina si se debe usar la Originalversión , Currento Proposed del valor de columna. Esta funcionalidad se usa con frecuencia para incluir valores originales en la cláusula WHERE de una instrucción UPDATE para comprobar si hay infracciones de simultaneidad optimista.

Se aplica a