DbCommand.ExecuteScalar メソッド

  • リファレンス

定義

名前空間:
System.Data.Common
アセンブリ:
System.Data.Common.dll
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll

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

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 参照 (NothingVisual Basic) が返されます。 データベース内の値が指定されている場合、クエリDBNull.Valueは null.

適用対象

こちらもご覧ください