OracleCommand.ExecuteScalar メソッド

定義

名前空間:

System.Data.OracleClient

アセンブリ:

System.Data.OracleClient.dll

クエリを実行し、そのクエリから .NET データ型として返される結果セットの最初の行の最初の列を返します。 追加の列または行は無視されます。

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

public override object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

戻り値

Object

.NET データ型の結果セットの最初の行の最初の列。結果セットが空であるか、結果が REF CURSOR の場合は、null 参照。

例

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

public void CreateOracleCommand(string myScalarQuery, OracleConnection connection)
 {
    OracleCommand command = new OracleCommand(myScalarQuery, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
 }

Public Sub CreateOracleCommand(myScalarQuery As String, connection As OracleConnection)
    Dim command As New OracleCommand(myScalarQuery, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

注釈

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

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

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

こちらもご覧ください

• コマンドの操作