IDataAdapter.Update(DataSet) Метод

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

Параметры

Возвращаемое значение

Количество строк, успешно обновленных из объекта DataSet.

Исключения

Примеры

В следующем примере производный класс OleDbDataAdapterиспользуется для Update источника данных. В этом примере предполагается, что вы создали 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

Комментарии

Когда приложение вызывает Update метод , IDataAdapter класс проверяет RowState свойство и выполняет необходимые инструкции INSERT, UPDATE или DELETE итеративно для каждой строки в зависимости от порядка индексов, настроенных в DataSet. Например, Update может выполнить инструкцию DELETE, за которой следует инструкция INSERT, а затем еще одну инструкцию DELETE из-за порядка строк в DataTable.

Имейте в виду, что эти инструкции не выполняются как пакетный процесс; каждая строка обновляется по отдельности. Приложение может вызвать метод , GetChanges если необходимо управлять последовательностью типов инструкций (например, INSERTs перед UPDATEs). Дополнительные сведения см. в разделе Обновление источников данных с помощью DataAdapters.

Если инструкции INSERT, UPDATE или DELETE не указаны, Update метод создает исключение. Однако можно создать объект или OleDbCommandBuilder для автоматического SqlCommandBuilder создания инструкций SQL для обновлений из одной таблицы, если задано SelectCommand свойство поставщика данных платформа .NET Framework. Затем все дополнительные инструкции SQL, которые не заданы, создаются CommandBuilder. Для этой логики создания требуется, чтобы сведения о ключевом столбце присутствовали DataSetв . Дополнительные сведения см. в разделе Создание команд с помощью CommandBuilders.

Метод Update извлекает строки из таблицы, указанной в первом сопоставлении, перед выполнением обновления. Затем Update обновляет строку, используя значение UpdatedRowSource свойства . Все возвращаемые дополнительные строки игнорируются.

После загрузки всех данных обратно в DataSetвызывается событие , OnRowUpdated что позволяет пользователю проверить выверяемую DataSet строку и все выходные параметры, возвращаемые командой . После успешного обновления строки изменения в этой строке принимаются.

При использовании Updateпорядок выполнения выглядит следующим образом:

1. Значения в перемещаются DataRow в значения параметров.

2. Возникает событие OnRowUpdating.

3. Команда выполняется.

4. Если для команды задано значение FirstReturnedRecord, то первый возвращенный результат помещается в DataRow.

5. Если есть выходные параметры, они помещаются в DataRow.

6. Возникает событие OnRowUpdated.

7. Вызывается метод AcceptChanges.

Каждая команда, связанная с , IDataAdapter обычно имеет коллекцию параметров, связанную с ней. Параметры сопоставляются с текущей строкой с помощью SourceColumn свойств и SourceVersion класса поставщика Parameter данных платформа .NET Framework. SourceColumn ссылается на столбец DataTable , на который IDataAdapter ссылается для получения значений параметров для текущей строки.

SourceColumn ссылается на несопоставленное имя столбца перед применением каких-либо сопоставлений таблиц. Если SourceColumn ссылается на несуществующий столбец, то выполняемое действие зависит от одного из следующих MissingMappingAction значений.

Свойство SourceColumn также используется для сопоставления значения выходных или входных/выходных параметров с DataSet. Исключение создается, если оно ссылается на несуществующий столбец.

Свойство SourceVersion класса поставщика Parameter данных платформа .NET Framework определяет, следует ли использовать OriginalCurrent, или Proposed версию значения столбца. Эта возможность часто используется для включения исходных значений в предложение WHERE инструкции UPDATE для проверка нарушений оптимистического параллелизма.

Применяется к