SqlCeCommand.ExecuteScalar メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCeCommand.ExecuteScalar メソッド

クエリを実行し、そのクエリが返す結果セットの最初の行にある最初の列を返します。残りの列または行は無視されます。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 ExecuteScalar As Object

Visual Basic (使用法)

Dim instance As SqlCeCommand
Dim returnValue As Object

returnValue = instance.ExecuteScalar

C#

public override Object ExecuteScalar ()

C++

public:
virtual Object^ ExecuteScalar () override

J#

public Object ExecuteScalar ()

JScript

public override function ExecuteScalar () :
 Object

戻り値
結果セット内の最初の行の最初の列。

例外

例外の種類	条件
InvalidOperationException	接続を登録した当初のトランザクション コンテキストとは異なるコンテキストでは、コマンドを実行できません。

解説

データ ソースから単一の値 (集計値など) を取得するには、ExecuteScalar メソッドを使用します。ExecuteReader メソッドを使用し、SqlCeDataReader によって返されたデータから単一値を生成するよりも、このメソッドを使用した方がコードが簡潔になります。

使用例

SqlCeCommand を作成し、ExecuteScalar を使用して実行する例を次に示します。この例では、集計結果を返す SQL ステートメントの文字列と、データ ソースへの接続用の文字列が渡されます。

Visual Basic

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

C#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeCommand クラス
SqlCeCommand メンバ
System.Data.SqlServerCe 名前空間