OleDbCommand.ExecuteScalar メソッド

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

アセンブリ:

System.Data.dll

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

public:
 override System::Object ^ ExecuteScalar();

public:
 virtual System::Object ^ ExecuteScalar();

public override object ExecuteScalar ();

public override object? ExecuteScalar ();

public object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Public Function ExecuteScalar () As Object

戻り値

Object

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

実装

ExecuteScalar()

例外

InvalidOperationException

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

例

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

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

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

注釈

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

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

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

こちらもご覧ください

• コマンドの操作