DbCommand.ExecuteScalar メソッド

定義

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

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

返品

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

実装

注釈

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

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

適用対象

こちらもご覧ください