OleDbCommand.ExecuteScalar メソッド

定義

クエリを実行し、クエリによって返される結果セットの先頭行の最初の列を返します。 その他の列または行は無視されます。

public override object? ExecuteScalar ();
public object ExecuteScalar ();
public override object ExecuteScalar ();

戻り値

結果セットの先頭行の最初の列です。結果セットが空の場合は NULL 参照です。

実装

例外

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

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

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

注釈

メソッドを ExecuteScalar 使用して、集計値などの単一の値をデータ ソースから取得します。 これには、 メソッドを使用するよりも少ないコードが ExecuteReader 必要です。次に、 によって返されるデータを使用して単一の値を生成するために必要な操作を OleDbDataReader実行します。

一般的な ExecuteScalar クエリは、次の C# の例のように書式設定できます。

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

適用対象

製品 バージョン
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

こちらもご覧ください