DB2Command.ExecuteScalar メソッド
照会を実行して、その照会によって戻される結果セットの最初の行の最初の列を戻します。 その他の列や行は無視されます。
- 名前空間:
IBM.Data.DB2
- アセンブリー:
IBM.Data.DB2
(IBM.Data.DB2.dll
内)
構文
[Visual Basic]
NotOverridable Public Function ExecuteScalar() As Object
[C#]
public object ExecuteScalar();
[C++]
public: __sealed Object* ExecuteScalar();
[JScript]
public function ExecuteScalar() : Object;
戻り値
結果セットの最初の行の最初の列。
注釈
ExecuteScalar メソッドを使用して、データベースから単一の値 (集約値など) を検索します。 これに必要なコードは、 ExecuteReader メソッドを使用して、 DB2®DataReader によって返されるデータから単一値を生成するために必要な操作を実行するよりも少なくなります。
典型的な ExecuteScalar 照会は、以下の C# の例に示す方法でフォーマット設定することができます。
CommandText = "select count(*) as NumberOfEmployee from EMPLOYEE";
Int count = (int) ExecuteScalar();
例
[Visual Basic、C#] 以下の例では、 DB2コマンド を作成し、それを ExecuteScalarを使用して実行します。 この例には、集約結果を戻す SQL ステートメントであるストリングと、 データベースへの接続に使用するストリングが渡されます。
[Visual Basic]
Public Sub CreateMyDB2Command(myScalarQuery As String,
myConnection As DB2Connection)
Dim myCommand As New DB2Command(myScalarQuery, myConnection)
myCommand.Connection.Open()
Dim qryValue As object = myCommand.ExecuteScalar()
myConnection.Close()
End Sub 'CreateMyDB2Command
[C#]
public void CreateMyDB2Command(string myScalarQuery, DB2Connection myConnection)
{
DB2Command myCommand = new DB2Command(myScalarQuery, myConnection);
myCommand.Connection.Open();
object qryValue = myCommand.ExecuteScalar();
myConnection.Close();
}