SqlCeCommandBuilder.GetUpdateCommand Method ()

Artigo
01/14/2011

Obtém o objeto SqlCeCommand gerado automaticamente necessário para executar atualizações do banco de dados quando o aplicativo chama Update no SqlCeDataAdapter.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)

Sintaxe

'Declaração
Public Function GetUpdateCommand As SqlCeCommand

public SqlCeCommand GetUpdateCommand ()

public:
SqlCeCommand^ GetUpdateCommand ()

public SqlCeCommand GetUpdateCommand ()

public function GetUpdateCommand () : SqlCeCommand

Valor de retorno

O objeto SqlCeCommand gerado automaticamente necessário para executar atualizações.

Comentários

Um aplicativo pode usar o método GetUpdateCommand para fins informativos ou de solução de problemas, pois ele retornar o objeto SqlCeCommand a ser executado.

Você também pode usar o GetUpdateCommand como a base do comando modificado. Por exemplo, pode chamar GetUpdateCommand, modificar uma de suas propriedade e defini-lo explicitamente no SqlCeDataAdapter.

Depois que a instrução SQL é gerada pela primeira vez, o aplicativo deverá chamar RefreshSchema explicitamente, se o aplicativo alterar a instrução SQL de alguma forma. Caso contrário, o GetUpdateCommand ainda usará as informações da instrução anterior e essas informações podem não estar corretas. As instruções SQL são geradas pela primeira vez quando o aplicativo chama Update ou GetUpdateCommand.

Exemplo

O exemplo a seguir mostra a chamada do método GetUpdateCommand do 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());
}

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeCommandBuilder Class
SqlCeCommandBuilder Members
System.Data.SqlServerCe Namespace

Partilhar via