Condividi tramite


OleDbCommand.ExecuteScalar Metodo

Definizione

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:
 virtual System::Object ^ ExecuteScalar();
public override object? ExecuteScalar ();
public object ExecuteScalar ();
public override object ExecuteScalar ();
override this.ExecuteScalar : unit -> obj
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Overrides Function ExecuteScalar () As Object
Public Function ExecuteScalar () As Object

Restituisce

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

Implementazioni

Eccezioni

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

Si applica a

Vedi anche