OleDbCommand.ExecuteScalar メソッド

定義

名前空間:
System.Data.OleDb
アセンブリ:
System.Data.dll

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

public:
 virtual System::Object ^ ExecuteScalar();
public:
 override System::Object ^ ExecuteScalar();
public object ExecuteScalar();
public override object ExecuteScalar();
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object
Public Overrides 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 メソッドを使用して、集計値などの単一の値をデータ ソースから取得します。 これには、 ExecuteReader メソッドを使用して、 OleDbDataReaderによって返されるデータを使用して単一の値を生成するために必要な操作を実行するよりも少ないコードが必要です。

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

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

適用対象

こちらもご覧ください