IDbCommand.ExecuteScalar 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

执行查询，并返回由查询返回的结果集中第一行的第一列。 忽略其他列或行。

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar ();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

返回

Object

结果集中第一行的第一列。

示例

以下示例创建派生类 的实例， SqlCommand然后使用 执行它 ExecuteScalar。 该示例将传递一个字符串，该字符串是返回聚合结果的 Transact-SQL 语句，以及用于连接到数据源的字符串。

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

注解

ExecuteScalar使用 方法检索单个值 (例如，从数据库) 聚合值。 这需要的代码比使用 ExecuteReader 方法少，然后执行使用 返回 IDataReader的数据生成单个值所需的操作。

典型 ExecuteScalar 查询的格式可以设置为以下 C# 示例中的格式：

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

如果未找到结果集中第一行的第一列，则返回 Visual Basic) Nothing 中的 null 引用 (。 如果数据库中 null的值为 ，则查询返回 DBNull.Value。