Udostępnij za pośrednictwem


OleDbCommand.ExecuteScalar Metoda

Definicja

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:
 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

Zwraca

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

Implementuje

Wyjątki

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

Dotyczy

Zobacz też