DbCommand.ExecuteScalar メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。その他の列、行、結果セットはすべて無視されます。

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

public abstract object ExecuteScalar ();

public abstract object? ExecuteScalar ();

abstract member ExecuteScalar : unit -> obj

Public MustOverride Function ExecuteScalar () As Object

Object

最初の結果セットの最初の行の最初の列。

ExecuteScalar()

メソッドを ExecuteScalar 使用して、データベースから単一の値 (集計値など) を取得します。これには、メソッドを使用し、によって返されるデータを使用 ExecuteReader して単一の値を生成するために必要な操作を実行するよりも少ないコードが DbDataReader必要です。

結果セットの最初の行の最初の列が見つからない場合は、null 参照 (Nothing Visual Basic では ) が返されます。データベースの値がの場合、クエリは nullを返します DBNull.Value。

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0