SqlCeCommand.ExecuteScalar Method

執行查詢，並傳回查詢所傳回的結果集中第一個資料列的第一個資料行。會忽略額外的資料行或資料列。

命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 system.data.sqlserverce.dll)

語法

'宣告
Public Overrides Function ExecuteScalar As Object

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : Object

傳回值

結果集中第一個資料列的第一個資料行。

例外狀況

例外狀況型別	條件
InvalidOperationException	如果某項交易內容與原本連接登記的內容不同，便無法在那個交易內容中執行命令。

備註

使用 ExecuteScalar 方法從資料來源擷取單一值 (例如彙總值)。與使用 ExecuteReader 方法，然後執行必要的作業，以使用 SqlCeDataReader 所傳回的資料來產生單一值相較，上述方法需要的程式碼較少。

範例

下列範例會建立 SqlCeCommand，然後使用 ExecuteScalar 加以執行。範例會傳遞為傳回彙總結果之 SQL 陳述式的字串和用於連接至資料來源的字串。

Dim cmd As New SqlCeCommand("SELECT col1 FROM myTable", conn)
cmd.Connection.Open()
Dim value As Object = cmd.ExecuteScalar()
conn.Close()

SqlCeCommand cmd = new SqlCeCommand("SELECT col1 FROM myTable", conn);
cmd.Connection.Open();
object value = cmd.ExecuteScalar();
conn.Close();

執行緒安全性

任何公用靜態 (共用 在 Microsoft Visual Basic) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
版本資訊
.NET Framework 及 NET Compact Framework
支援於 3.5
.NET Framework
支援於 3.0
.NET Compact Framework 及 .Net Framework
支援於 2.0

另請參閱

參考

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace