ExecuteScalar 方法
執行查詢,並傳回查詢所傳回的結果集中第一個資料列的第一個資料行。會忽略額外的資料行或資料列。
命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)
語法
'宣告
Public Overrides Function ExecuteScalar As Object
'用途
Dim instance As SqlCeCommand
Dim returnValue As Object
returnValue = instance.ExecuteScalar()
public override Object ExecuteScalar()
public:
virtual Object^ ExecuteScalar() override
abstract ExecuteScalar : unit -> Object
override ExecuteScalar : unit -> Object
public override function ExecuteScalar() : Object
傳回值
型別:System. . :: . .Object
結果集中第一個資料列的第一個資料行。
實作
IDbCommand. . :: . .ExecuteScalar() () () ()
例外
例外狀況 | 條件 |
---|---|
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();