Метод предоставляет автоматически сгенерированный для выполнения операции обновления записей в БД объект DbCommand.

Клиентское приложение может с помощью метода GetUpdateCommand получить сгенерированный SQL-запрос UPDATE и, при необходимости, модифицировать его (например, изменить значение CommandTimeout, а затем явно задать это значение для DbDataAdapter). В этом случае приложение должно явным образом вызвать метод RefreshSchema, если каким-либо образом изменится SELECT-запрос в свойстве DbDataAdapter.SelectCommand. В противном случае метод GetUpdateCommand будет продолжать использовать сведения от предыдущих команд, которые могут оказаться неверными.

Первоначально SQL-команды создаются, когда приложение вызывает метод Update, либо метод GetUpdateCommand.

Синтаксис

public DbCommand GetUpdateCommand();

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

Автоматически созданный объект DbCommand, содержащий текст SQL-запроса для обновления записей в таблице БД.

Исключения

Отсутствуют.

Пример

// C#
using System;
using System.Data;
using System.Data.Common;

class CommandBuilderSample
{
  static void Main()
  {
    // Создание фабрики классов провайдера
    DbProviderFactory factory =
      DbProviderFactories.GetFactory("System.Data.LinterClient");
    // Соединение с БД
    DbConnection con = factory.CreateConnection();
    con.ConnectionString = "DataSource=LOCAL;UserID=SYSTEM;Password=MANAGER8";
    con.Open();
    DbCommand cmd = factory.CreateCommand();
    cmd.CommandText = "select MAKE, PERSONID from AUTO";
    cmd.Connection = con;
    DbDataAdapter adapter = factory.CreateDataAdapter();
    adapter.SelectCommand = cmd;
    // Связывание объектов DbDataAdapter и DbCommandBuilder
    DbCommandBuilder builder = factory.CreateCommandBuilder();
    builder.DataAdapter = adapter;
    // Отображение автоматически сгенерированной команды UPDATE
    Console.WriteLine(builder.GetUpdateCommand().CommandText);
    // Освобождение ресурсов
    builder.Dispose();
    // Закрытие подключения к БД
    con.Close();
  }
}

Результат выполнения примера:

UPDATE "SYSTEM"."AUTO" SET "MAKE" = :param1, "PERSONID" = :param2
WHERE (((:param3 = 1 AND "MAKE" IS NULL) OR ("MAKE" = :param4)) AND ("PERSONID" = :param5))