IDbCommand.ExecuteScalar 方法
执行查询，并返回查询所返回的结果集中第一行的第一列。忽略额外的列或行。
**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）
语法
声明
Function ExecuteScalar As Object
用法
Dim instance As IDbCommand
Dim returnValue As Object
returnValue = instance.ExecuteScalar
Object ExecuteScalar ()
Object^ ExecuteScalar ()
Object ExecuteScalar ()
function ExecuteScalar () : Object
返回值
结果集中第一行的第一列。
备注
使用 ExecuteScalar 方法从数据库中检索单个值（例如一个聚合值）。与使用 ExecuteReader 方法，然后使用 IDataReader 返回的数据执行生成单个值所需的操作相比，此操作需要的代码较少。
典型的 ExecuteScalar 查询可以采用类似于下面的 C# 示例的格式：
CommandText = "select count(*) as NumberOfRegions from region";
Int32 count = (int) ExecuteScalar();
示例
下面的示例创建派生类 SqlCommand 的实例，然后使用 ExecuteScalar 执行它。为该示例传递两个字符串：一个是返回聚合结果的 Transact-SQL 语句，另一个用于连接到数据源。
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
public void CreateSqlCommand(
string queryString, SqlConnection connection)
{
SqlCommand command = new
SqlCommand(queryString, connection);
command.Connection.Open();
command.ExecuteScalar();
connection.Close();
}
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0