DbCommand.ExecuteScalar Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.Common
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll
Źródło:
DbCommand.cs
Źródło:
DbCommand.cs
Źródło:
DbCommand.cs

Wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.

public:
 abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar ();
public abstract object? ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object

Zwraca

Object

Pierwsza kolumna pierwszego wiersza w pierwszym zestawie wyników.

Implementuje

ExecuteScalar()

Uwagi

ExecuteScalar Użyj metody , aby pobrać pojedynczą wartość (na przykład zagregowaną wartość) z bazy danych. Wymaga to mniejszej ExecuteReader ilości kodu niż użycie metody i wykonanie operacji niezbędnych do wygenerowania pojedynczej wartości przy użyciu danych zwracanych przez metodę DbDataReader.

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

Dotyczy

Zobacz też