Metodo SqlCeCommandBuilder.GetUpdateCommand

Articolo
05/27/2011

Ottiene l'oggetto SqlCeCommand generato automaticamente richiesto per l'esecuzione di operazioni di aggiornamento sul database quando un'applicazione chiama il metodo Update sull'oggetto SqlCeDataAdapter.

Spazio dei nomi System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
Public Function GetUpdateCommand As SqlCeCommand
'Utilizzo
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

Valore restituito

Tipo: System.Data.SqlServerCe.SqlCeCommand
Oggetto SqlCeCommand generato automaticamente e necessario per eseguire le operazioni di aggiornamento.

Osservazioni

In un'applicazione è possibile utilizzare il metodo GetUpdateCommand a scopi informativi o di risoluzione dei problemi, in quanto il metodo restituisce l'oggetto SqlCeCommand da eseguire.

È inoltre possibile utilizzare il metodo GetUpdateCommand come base di un comando modificato. Ad esempio, è possibile chiamare il metodo GetUpdateCommand, modificare una delle relative proprietà, quindi impostarlo esplicitamente sull'oggetto SqlCeDataAdapter.

Dopo che è stata generata l'istruzione SQL, è necessario che il metodo RefreshSchema() venga chiamato esplicitamente, se l'applicazione modifica in qualsiasi modo l'istruzione SQL. In caso contrario, il metodo GetUpdateCommand continua a utilizzare le informazioni dell'istruzione precedente, che potrebbero essere errate. Le istruzioni SQL sono generate per prime quando l'applicazione chiama il metodo Update o GetUpdateCommand.

Esempi

Nell'esempio che segue viene illustrata la chiamata al metodo GetUpdateCommand dell'oggetto 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());
}

Vedere anche

Riferimento

SqlCeCommandBuilder Classe

Overload GetUpdateCommand

Spazio dei nomi System.Data.SqlServerCe

Condividi tramite