SqlCeCommandBuilder.GetUpdateCommand Method ()

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

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

Синтаксис

'Декларация
Public Function GetUpdateCommand As SqlCeCommand

public SqlCeCommand GetUpdateCommand ()

public:
SqlCeCommand^ GetUpdateCommand ()

public SqlCeCommand GetUpdateCommand ()

public function GetUpdateCommand () : SqlCeCommand

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

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

Замечания

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

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

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

Пример

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

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());
}

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeCommandBuilder Class
SqlCeCommandBuilder Members
System.Data.SqlServerCe Namespace