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();
 }