OleDbCommand.ExecuteScalar Methode

Definition

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile in dem von der Abfrage zurückgegebenen Resultset zurück.Executes the query, and returns the first column of the first row in the result set returned by the query. Weitere Spalten oder Zeilen werden ignoriert.Additional columns or rows are ignored.

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

Gibt zurück

Die erste Spalte der ersten Zeile im Resultset oder ein NULL-Verweis, wenn das Resultset leer ist.The first column of the first row in the result set, or a null reference if the result set is empty.

Implementiert

Ausnahmen

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Beispiele

Im folgenden Beispiel wird eine OleDbCommand erstellt und dann mit ExecuteScalarausgeführt.The following example creates an OleDbCommand and then executes it using ExecuteScalar. Im Beispiel wird eine Zeichenfolge mit einer SQL-Anweisung, die ein Aggregat Ergebnis zurückgibt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet wird,The example is passed a string that is an SQL statement that returns an aggregate result, and a string to use to connect to the data source.

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 

Hinweise

Verwenden Sie die ExecuteScalar-Methode, um einen einzelnen Wert (z. b. einen Aggregatwert) aus einer Datenquelle abzurufen.Use the ExecuteScalar method to retrieve a single value, for example, an aggregate value, from a data source. Dies erfordert weniger Code als die Verwendung der ExecuteReader-Methode und dann die Vorgänge, die erforderlich sind, um den einzelnen Wert mithilfe der von einer OleDbDataReaderzurückgegebenen Daten zu generieren.This requires less code than using the ExecuteReader method, and then performing the operations that are required to generate the single value using the data returned by an OleDbDataReader.

Eine typische ExecuteScalar Abfrage kann wie im folgenden C# Beispiel formatiert werden:A typical ExecuteScalar query can be formatted as in the following C# example:

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

Gilt für:

Siehe auch