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值所需的作業。

如果找不到結果集中第一個數據列的第一個數據行，則會傳回 Visual Basic) 中的 null 參考 Nothing (。如果資料庫中的值是 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