SqlCeCommandBuilder.GetInsertCommand Method ()

Artigo
01/14/2011

Obtém o objeto SqlCeCommand gerado automaticamente necessário para executar inserções no 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 GetInsertCommand As SqlCeCommand

public SqlCeCommand GetInsertCommand ()

public:
SqlCeCommand^ GetInsertCommand ()

public SqlCeCommand GetInsertCommand ()

public function GetInsertCommand () : SqlCeCommand

Valor de retorno

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

Comentários

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

Você também pode usar o GetInsertCommand como a base do comando modificado. Por exemplo, pode chamar GetInsertCommand, 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 de alguma forma. Caso contrário, o GetInsertCommand 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 GetInsertCommand.

Exemplo

O exemplo a seguir mostra a chamada do método GetInsertCommand 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

Compartilhar via