IDbCommand.ExecuteScalar Metoda

Definicja

Namespace:

System.Data

Zestawów:

netstandard.dll, System.Data.Common.dll

Źródło:

IDbCommand.cs

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

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

Zwraca

Object

Pierwsza kolumna pierwszego wiersza w zestawie wyników.

Przykłady

Poniższy przykład tworzy wystąpienie klasy pochodnej , SqlCommanda następnie wykonuje je przy użyciu polecenia ExecuteScalar. Przykład jest przekazywany ciąg, który jest instrukcją Języka Transact-SQL zwracającą zagregowany wynik, oraz ciąg używany do nawiązywania połączenia ze źródłem danych.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Uwagi

ExecuteScalar Użyj metody , aby pobrać pojedynczą wartość (na przykład wartość agregowaną) z bazy danych. Wymaga to mniejszego ExecuteReader kodu niż użycie metody, a następnie wykonania operacji niezbędnych do wygenerowania pojedynczej wartości przy użyciu danych zwracanych przez IDataReaderelement .

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

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

Jeśli pierwsza kolumna pierwszego wiersza w zestawie wyników nie zostanie znaleziona, zostanie zwrócone odwołanie o wartości null (Nothing w Visual Basic). Jeśli wartość w bazie danych to null, zapytanie zwraca wartość DBNull.Value.