SqlCeCommand Class

Articolo
01/14/2011

Rappresenta un'istruzione SQL da eseguire in relazione a un'origine dati.

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

Sintassi

'Dichiarazione
Public NotInheritable Class SqlCeCommand
    Inherits DbCommand
    Implements ICloneable

public sealed class SqlCeCommand : DbCommand, ICloneable

public ref class SqlCeCommand sealed : public DbCommand, ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

Osservazioni

Quando viene creata un'istanza della classe SqlCeCommand, le proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il costruttore della classe SqlCeCommand.

L'oggetto SqlCeCommand comprende i seguenti metodi per l'esecuzione di comandi in un'origine dati:

Elemento	Descrizione
ExecuteReader	Esegue i comandi che restituiscono righe.
ExecuteNonQuery	Esegue comandi SQL quali istruzioni INSERT, DELETE e UPDATE.
ExecuteScalar	Recupera un valore singolo, ad esempio un valore aggregato, da un database.
ExecuteResultSet	Esegue i comandi e restituisce un gruppo di risultati.

Il provider di dati per SQL Server Compact 3.5 non supporta l'esecuzione di query raggruppate in batch. I comandi devono essere nel seguente formato:

Select * from Customers e non Select * from Customers; Select * from Orders;

Se si utilizza un codice generato per System.Data.SqlClient, può essere necessario modificare le query in modo conforme a questa restrizione.

In SQL Server Compact 3.5 sono supportate più connessioni simultanee nonché più comandi che condividono la stessa connessione. Pertanto è possibile disporre di più istanze di SqlCeDataReader sulla stessa connessione. Questo comportamento è diverso da quello di System.Data.SqlClient.

Se viene generata un'eccezione SqlCeException irreversibile dal metodo durante l'esecuzione di un comando SqlCeCommand, è possibile che la connessioneSqlCeConnection venga chiusa. È possibile riaprire la connessione e continuare.

Gerarchia di ereditarietà

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

Esempio

Nell'esempio che segue vengono utilizzati gli oggetti SqlCeCommand e SqlCeConnection per selezionare le righe da un database.

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}

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

SqlCeCommand Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeConnection

Condividi tramite