Метод SqlCeCommandBuilder.GetUpdateCommand

Статья
05/27/2011

Возвращает автоматически созданный объект SqlCeCommand, необходимый для выполнения операций вставки в базе данных при вызове приложением метода Update объекта SqlCeDataAdapter.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)

Синтаксис

'Декларация
Public Function GetUpdateCommand As SqlCeCommand
'Применение
Dim instance As SqlCeCommandBuilder
Dim returnValue As SqlCeCommand

returnValue = instance.GetUpdateCommand()

public SqlCeCommand GetUpdateCommand()

public:
SqlCeCommand^ GetUpdateCommand()

member GetUpdateCommand : unit -> SqlCeCommand

public function GetUpdateCommand() : SqlCeCommand

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

Тип: System.Data.SqlServerCe.SqlCeCommand
Автоматически созданный объект SqlCeCommand, необходимый для выполнения операций обновления.

Замечания

Приложение может использовать метод GetUpdateCommand для устранения неполадок и получения сведений, поскольку он возвращает объект SqlCeCommand для выполнения.

Создать заготовку команды можно также при помощи GetUpdateCommand. Например, можно вызвать GetUpdateCommand, изменить одно из его свойств, а затем явным образом присвоить команду SqlCeDataAdapter.

Если приложение каким-либо образом изменило инструкцию SQL после ее начального формирования, необходимо явно вызвать RefreshSchema(). В противном случае GetUpdateCommand будет по-прежнему пользоваться данными ранее существовавшей инструкции, которая может не соответствовать действительности. Начальное формирование инструкций SQL производится в тот момент, когда приложение вызывает Update или GetUpdateCommand.

Примеры

В следующем примере производится вызов метода GetUpdateCommand SqlCeCommandBuilder.

Try
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM employees"

    Dim adp As New SqlCeDataAdapter(cmd)

    Dim cb As New SqlCeCommandBuilder()
    cb.DataAdapter = adp

    MessageBox.Show(cb.GetUpdateCommand().CommandText)
    MessageBox.Show(cb.GetInsertCommand().CommandText)
    MessageBox.Show(cb.GetDeleteCommand().CommandText)

    Dim ds As New DataSet("test")
    adp.Fill(ds)

    ' Modify the contents of the DataSet
    '
    ds.Tables(0).Rows(0)("First Name") = "Joe"

    adp.Update(ds)

Catch e1 As Exception
    Console.WriteLine(e1.ToString())
End Try

try
{
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(cmd);

    SqlCeCommandBuilder cb = new SqlCeCommandBuilder();
    cb.DataAdapter = adp;

    MessageBox.Show(cb.GetUpdateCommand().CommandText);
    MessageBox.Show(cb.GetInsertCommand().CommandText);
    MessageBox.Show(cb.GetDeleteCommand().CommandText);

    DataSet ds = new DataSet("test");
    adp.Fill(ds);

    // Modify the contents of the DataSet
    //
    ds.Tables[0].Rows[0]["First Name"] = "Joe";

    adp.Update(ds);

}
catch (Exception e1)
{
    Console.WriteLine(e1.ToString());
}

См. также

Справочник

SqlCeCommandBuilder Класс

Перегрузка GetUpdateCommand

Пространство имен System.Data.SqlServerCe

Поделиться через