SqlCeCommandBuilder.GetUpdateCommand Method ()

Articolo
01/14/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

public SqlCeCommand GetUpdateCommand ()

public:
SqlCeCommand^ GetUpdateCommand ()

public SqlCeCommand GetUpdateCommand ()

public function GetUpdateCommand () : SqlCeCommand

Valore restituito

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.

Esempio

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

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeCommandBuilder Class
SqlCeCommandBuilder Members
System.Data.SqlServerCe Namespace

Condividi tramite