DbCommand.ExecuteScalar メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。 他のすべての列、行、結果セットは無視されます。
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を返します。