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();