OleDbCommand.ExecuteScalar 方法

定义

命名空间:
System.Data.OleDb
程序集:
System.Data.dll

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

public:
 virtual System::Object ^ ExecuteScalar();
public:
 override System::Object ^ ExecuteScalar();
public object ExecuteScalar();
public override object ExecuteScalar();
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object
Public Overrides Function ExecuteScalar () As Object

返回

Object

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

实现

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 该方法，然后执行使用由 an OleDbDataReader返回的数据生成单个值所需的操作。

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

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

适用于

另请参阅