GetUpdateCommand
Метод предоставляет автоматически сгенерированный для выполнения операции обновления записей в БД объект 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))