OleDbCommand.ExecuteScalar Metodo

Definizione

Spazio dei nomi:
System.Data.OleDb
Assembly:
System.Data.dll

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.

public:
 virtual System::Object ^ ExecuteScalar();
public:
 override System::Object ^ ExecuteScalar();
public object ExecuteScalar();
public override object ExecuteScalar();
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object
Public Overrides Function ExecuteScalar () As Object

Valori restituiti

Object

Prima colonna della prima riga del set di risultati o riferimento Null se il set di risultati è vuoto.

Implementazioni

ExecuteScalar()

Eccezioni

InvalidOperationException

Impossibile eseguire un comando all'interno di un contesto di transazione diverso dal contesto in cui è stata originariamente inserita la connessione.

Esempio

Nell'esempio seguente viene creato un oggetto OleDbCommand e quindi 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

Utilizzare 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