OleDbCommand.ExecuteScalar Methode

Definition

Namespace:
System.Data.OleDb
Assembly:
System.Data.dll

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, die von der Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.

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

Gibt zurück

Object

Die erste Spalte der ersten Zeile im Resultset oder ein Nullverweis, wenn das Resultset leer ist.

Implementiert

ExecuteScalar()

Ausnahmen

InvalidOperationException

Innerhalb eines Transaktionskontexts kann kein Befehl ausgeführt werden, der sich vom Kontext unterscheidet, in dem die Verbindung ursprünglich aufgelistet wurde.

Beispiele

Das folgende Beispiel erstellt ein OleDbCommand und führt es dann mithilfe ExecuteScalarvon . Das Beispiel wird eine Zeichenfolge übergeben, die eine SQL-Anweisung ist, die ein Aggregatergebnis zurückgibt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll.

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. Dies erfordert weniger Code als die Verwendung der ExecuteReader Methode und führt dann die Vorgänge aus, die erforderlich sind, um den einzelnen Wert mithilfe der von einem OleDbDataReader.

Eine typische ExecuteScalar Abfrage kann wie im folgenden C#-Beispiel formatiert werden:

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

Gilt für:

Weitere Informationen