Classe SqlCeCommand

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

Gerarchia di ereditarietà

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

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
'Utilizzo
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

Nel tipo SqlCeCommand sono esposti i membri seguenti.

Costruttori

	Nome	Descrizione
	SqlCeCommand()	Inizializza una nuova istanza della classe SqlCeCommand.
	SqlCeCommand(String)	Inizializza una nuova istanza della classe SqlCeCommand con il testo della query.
	SqlCeCommand(String, SqlCeConnection)	Inizializza una nuova istanza della classe SqlCeCommand con il testo della query e un oggetto SqlCeConnection.
	SqlCeCommand(String, SqlCeConnection, SqlCeTransaction)	Inizializza una nuova istanza della classe SqlCeCommand con il testo della query, un oggetto SqlCeConnection e l'oggetto SqlCeTransaction.

In alto

Proprietà

	Nome	Descrizione
	CanRaiseEvents	(ereditato da Component)
	CommandText	Ottiene o imposta un'istruzione SQL da eseguire nell'origine dati. Esegue l'override di DbCommand.CommandText.
	CommandTimeout	Ottiene o imposta il tempo di attesa prima di terminare il tentativo di esecuzione di un comando e di generare un errore. Esegue l'override di DbCommand.CommandTimeout.
	CommandType	Ottiene o imposta un valore che indica come viene interpretata la proprietà CommandText. Esegue l'override di DbCommand.CommandType.
	Connection	Ottiene o imposta la classe SqlCeConnection utilizzata da questa istanza della classe SqlCeCommand.
	Container	(ereditato da Component)
	DbConnection	(ereditato da DbCommand)
	DbParameterCollection	(ereditato da DbCommand)
	DbTransaction	(ereditato da DbCommand)
	DesignMode	(ereditato da Component)
	DesignTimeVisible	Get restituisce sempre false, mentre Set genera sempre un'eccezione NotSupportedException. Esegue l'override di DbCommand.DesignTimeVisible.
	Events	(ereditato da Component)
	IndexName	Specifica l'indice da aprire.
	Parameters	Ottiene la classe SqlCeParameterCollection.
	Site	(ereditato da Component)
	Transaction	Ottiene o imposta la transazione in cui viene eseguito l'oggetto SqlCeCommand.
	UpdatedRowSource	Ottiene o imposta le modalità di applicazione dei risultati del comando all'oggetto DataRow quando utilizzato dal metodo Update dell'oggetto DbDataAdapter. Non utilizzare questa proprietà con il provider di dati .NET Compact Framework per SQL Server Compact. Esegue l'override di DbCommand.UpdatedRowSource.

In alto

Metodi

	Nome	Descrizione
	Cancel	Esegue un tentativo di annullare l'esecuzione di un oggetto SqlCeCommand. Esegue l'override di DbCommand.Cancel().
	CreateDbParameter	(ereditato da DbCommand)
	CreateObjRef	(ereditato da MarshalByRefObject)
	CreateParameter	Consente di creare una nuova istanza dell'oggetto SqlCeParameter.
	Dispose()	(ereditato da Component)
	Dispose(Boolean)	(ereditato da Component)
	Equals	(ereditato da Object)
	ExecuteDbDataReader	(ereditato da DbCommand)
	ExecuteNonQuery	Esegue un'istruzione SQL in relazione alla classe SqlCeConnection e restituisce il numero di righe interessate. Esegue l'override di DbCommand.ExecuteNonQuery().
	ExecuteReader()	Invia la proprietà CommandText alla proprietà Connection e compila un oggetto SqlCeDataReader.
	ExecuteReader(CommandBehavior)	Invia la proprietà CommandText alla proprietà Connection e compila un oggetto SqlCeDataReader mediante uno dei valori dell'oggetto CommandBehavior.
	ExecuteResultSet(ResultSetOptions)	Invia la proprietà CommandText alla proprietà Connection e compila un oggetto SqlCeResultSet utilizzando l'oggetto ResultSetOptions.
	ExecuteResultSet(ResultSetOptions, SqlCeResultSet)	Invia la proprietà CommandText alla proprietà Connection e compila un oggetto SqlCeResultSet utilizzando l'oggetto ResultSetOptions.
	ExecuteScalar	Esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query. Le colonne o le righe aggiuntive vengono ignorate. Esegue l'override di DbCommand.ExecuteScalar().
	Finalize	(ereditato da Component)
	GetHashCode	(ereditato da Object)
	GetLifetimeService	(ereditato da MarshalByRefObject)
	GetService	(ereditato da Component)
	GetType	(ereditato da Object)
	InitializeLifetimeService	(ereditato da MarshalByRefObject)
	MemberwiseClone()	(ereditato da Object)
	MemberwiseClone(Boolean)	(ereditato da MarshalByRefObject)
	Prepare	Crea una versione preparata o compilata del comando sull'origine dati. Esegue l'override di DbCommand.Prepare().
	SetRange	Limita il set di righe che verrà letto dall'oggetto SqlCeDataReader.
	ToString	(ereditato da Component)

In alto

Eventi

	Nome	Descrizione
	Disposed	(ereditato da Component)

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	ICloneable.Clone
	IDbCommand.Connection	(ereditato da DbCommand)
	IDbCommand.CreateParameter	(ereditato da DbCommand)
	IDbCommand.ExecuteReader()	(ereditato da DbCommand)
	IDbCommand.ExecuteReader(CommandBehavior)	(ereditato da DbCommand)
	IDbCommand.Parameters	(ereditato da DbCommand)
	IDbCommand.Transaction	(ereditato da DbCommand)

In alto

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:

Il provider di dati per SQL Server Compact 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 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 connessione SqlCeConnection venga chiusa. È possibile riaprire la connessione e continuare.

Esempi

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

Protezione dei thread

I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe

SqlCeDataAdapter

SqlCeConnection