OleDbCommand.ExecuteScalar メソッド

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

OleDbCommand.ExecuteScalar メソッド

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

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

Visual Basic (宣言)

Public Overrides Function
 ExecuteScalar As Object

Visual Basic (使用法)

Dim instance As OleDbCommand
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

戻り値
結果セットの最初の行の最初の列。結果セットが空の場合は、null 参照。

例外

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

解説

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

ExecuteScalar クエリは、通常、次の形式で指定します。この例は、C# のコード例です。

CommandText = "SELECT COUNT(*) FROM region";
Int32 count = (int32) ExecuteScalar();

使用例

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

Visual Basic

Public Sub CreateMyOleDbCommand(queryString
 As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString,
 connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub 

C#

public void CreateMyOleDbCommand(string
 queryString, 
    OleDbConnection connection) 
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

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

参照

関連項目
OleDbCommand クラス
OleDbCommand メンバ
System.Data.OleDb 名前空間
その他の技術情報
コマンドの使用