OleDbCommand.ExecuteScalar 方法

定义

命名空间:

System.Data.OleDb

程序集:

System.Data.OleDb.dll

包:

System.Data.OleDb v9.0.0-rc.2.24473.5

Source:

OleDbCommand.cs

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

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

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

返回

Object

结果集中第一行的第一列；如果结果集为空，则为 Null 引用。

实现

ExecuteScalar()

例外

InvalidOperationException

不能在连接最初在其中登记的上下文之外的事务上下文中执行命令。

示例

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

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

注解

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

典型 ExecuteScalar 查询的格式可以如以下 C# 示例中所示：

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

另请参阅

• 使用命令