OleDbCommand.ExecuteScalar Metoda

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

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

Źródło:

OleDbCommand.cs

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie. Dodatkowe kolumny lub wiersze są ignorowane.

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

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Zwraca

Object

Pierwsza kolumna pierwszego wiersza w zestawie wyników lub odwołanie o wartości null, jeśli zestaw wyników jest pusty.

Implementuje

ExecuteScalar()

Wyjątki

InvalidOperationException

Nie można wykonać polecenia w kontekście transakcji, który różni się od kontekstu, w którym połączenie zostało pierwotnie wymienione.

Przykłady

Poniższy przykład tworzy obiekt OleDbCommand , a następnie wykonuje go przy użyciu polecenia ExecuteScalar. Przykład jest przekazywany ciąg, który jest instrukcją SQL zwracającą zagregowany wynik, oraz ciąg używany do nawiązywania połączenia ze źródłem danych.

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

Uwagi

ExecuteScalar Użyj metody , aby pobrać pojedynczą wartość, na przykład zagregowaną wartość ze źródła danych. Wymaga to mniejszego ExecuteReader kodu niż użycie metody, a następnie wykonania operacji wymaganych do wygenerowania pojedynczej wartości przy użyciu danych zwróconych przez OleDbDataReaderelement .

Typowe ExecuteScalar zapytanie można sformatować tak, jak w poniższym przykładzie języka C#:

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

Zobacz też

• Praca z poleceniami