SqlCeCommand.ExecuteScalar Method

Esegue la query e restituisce la prima colonna della prima riga nel gruppo di risultati restituito dalla query. Le colonne o le righe aggiuntive vengono ignorate.

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

Sintassi

'Dichiarazione
Public Overrides Function ExecuteScalar As Object

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : Object

Valore restituito

Prima colonna della prima riga nel gruppo di risultati.

Eccezioni

Tipo di eccezione	Condizione
InvalidOperationException	Impossibile eseguire un comando all'interno di un contesto di transazione differente da quello in cui la connessione è stata in origine inserita.

Osservazioni

Utilizzare il metodo ExecuteScalar per recuperare un valore singolo, ad esempio un valore aggregato, da un'origine dati. L'operazione richiede una quantità inferiore di codice rispetto al metodo ExecuteReader e all'esecuzione delle operazioni necessarie a generare il valore singolo mediante i dati restituiti da un oggetto SqlCeDataReader.

Esempio

Nell'esempio seguente viene creata una classe SqlCeCommand, successivamente eseguita mediante il metodo ExecuteScalar. Nell'esempio viene passata una stringa che consiste in un'istruzione SQL che restituisce un risultato aggregato e una stringa per la connessione all'origine dati.

Dim cmd As New SqlCeCommand("SELECT col1 FROM myTable", conn)
cmd.Connection.Open()
Dim value As Object = cmd.ExecuteScalar()
conn.Close()

SqlCeCommand cmd = new SqlCeCommand("SELECT col1 FROM myTable", conn);
cmd.Connection.Open();
object value = cmd.ExecuteScalar();
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 Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace