OracleCommand.ExecuteScalar メソッド
メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。
クエリを実行し、そのクエリが .NET Framework のデータ型で返す結果セットの最初の行の最初の列を返します。残りの列または行は無視されます。
Public Overridable Function ExecuteScalar() As Object Implements _ IDbCommand.ExecuteScalar
[C#]
public virtual object ExecuteScalar();
[C++]
public: virtual Object* ExecuteScalar();
[JScript]
public function ExecuteScalar() : Object;
戻り値
.NET Framework 固有のデータ型の結果セットの最初の行の最初の列。結果セットが空であるか、結果が REF CURSOR の場合、null 参照。
実装
解説
ExecuteScalar メソッドを使用して、データベースから単一の値 (集計値など) を取得します。 ExecuteReader メソッドを使用し、 OracleDataReader によって返されたデータから単一値を生成するよりも、このメソッドを使用した方がコードが簡潔になります。
ExecuteScalar クエリは、通常、次の形式で指定します。この例は、C# のコード例です。
CommandText = "select count(*) from region";
Int32 count = (int32) ExecuteScalar();
使用例
[Visual Basic, C#, C++] OracleCommand を作成し、 ExecuteScalar を使用して実行する例を次に示します。この例では、集計結果を返す SQL ステートメントの文字列とデータベースへの接続に使用する文字列が渡されます。
Public Sub CreateMyOracleCommand(myScalarQuery As String, myConnection As OracleConnection)
Dim myCommand As New OracleCommand(myScalarQuery, myConnection)
myCommand.Connection.Open()
myCommand.ExecuteScalar()
myConnection.Close()
End Sub 'CreateMyOracleCommand
[C#]
public void CreateMyOracleCommand(string myScalarQuery, OracleConnection myConnection)
{
OracleCommand myCommand = new OracleCommand(myScalarQuery, myConnection);
myCommand.Connection.Open();
myCommand.ExecuteScalar();
myConnection.Close();
}
[C++]
public:
void CreateMyOracleCommand(String* myScalarQuery, OracleConnection* myConnection)
{
OracleCommand* myCommand = new OracleCommand(myScalarQuery, myConnection);
myCommand->Connection->Open();
myCommand->ExecuteScalar();
myConnection->Close();
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
OracleCommand クラス | OracleCommand メンバ | System.Data.OracleClient 名前空間