OleDbCommand.ExecuteScalar Metodo

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v9.0.0-rc.2.24473.5

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

public:
 override System::Object ^ ExecuteScalar();

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Restituisce

Object

Prima colonna della prima riga nel set di risultati o un riferimento null se il set di risultati è vuoto.

Implementazioni

ExecuteScalar()

Eccezioni

InvalidOperationException

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

Esempio

Nell'esempio seguente viene creato un oggetto OleDbCommand e quindi viene eseguito usando ExecuteScalar. Nell'esempio viene passata una stringa che è un'istruzione SQL che restituisce un risultato aggregato e una stringa da usare per connettersi all'origine dati.

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Commenti

Usare il ExecuteScalar metodo per recuperare un singolo valore, ad esempio un valore di aggregazione, da un'origine dati. Questo richiede meno codice rispetto all'uso del ExecuteReader metodo e quindi l'esecuzione delle operazioni necessarie per generare il singolo valore usando i dati restituiti da un oggetto OleDbDataReader.

Una query tipica ExecuteScalar può essere formattata come nell'esempio C# seguente:

CommandText = "SELECT COUNT(*) FROM region";  
Int32 count = (Int32) ExecuteScalar();  

Vedi anche

• Uso dei comandi