IDataAdapter.Update(DataSet) Método

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")]
public int Update(System.Data.DataSet dataSet);

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")>]
abstract member Update : System.Data.DataSet -> int

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

Public Function Update (dataSet As DataSet) As Integer

Parámetros

Devoluciones

Número de filas actualizadas correctamente desde DataSet.

Atributos

RequiresUnreferencedCodeAttribute

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 puede 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 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 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 las filas de la tabla enumeradas 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 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.

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 Parameter un proveedor de datos de .NET Framework. SourceColumn hace referencia a una DataTable columna que hace IDataAdapter referencia a para obtener valores de parámetro para la fila actual.

SourceColumn hace referencia al nombre de columna no asignado 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 del Parameter proveedor de datos de .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.