SqlCommand.ExecuteScalar 方法

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

**命名空间:**System.Data.SqlClient
**程序集:**System.Data（在 system.data.dll 中）

语法

声明
Public Overrides Function ExecuteScalar As Object
用法
Dim instance As SqlCommand
Dim returnValue As Object

returnValue = instance.ExecuteScalar

public override Object ExecuteScalar ()

public:
virtual Object^ ExecuteScalar () override

public Object ExecuteScalar ()

public override function ExecuteScalar () : Object

返回值

结果集中第一行的第一列或空引用（如果结果集为空）。

异常

异常类型	条件
SqlException	在对锁定的行执行该命令期间发生了异常。如果使用的是 Microsoft .NET Framework 1.0 版，将不会生成该异常。

备注

使用 ExecuteScalar 方法从数据库中检索单个值（例如一个聚合值）。与使用 ExecuteReader 方法，然后使用 SqlDataReader 返回的数据执行生成单个值所需的操作相比，此操作需要的代码较少。

典型的 ExecuteScalar 查询可以采用类似于下面的 C# 示例的格式：

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

示例

下面的示例创建一个 SqlCommand，然后使用 ExecuteScalar 执行它。向该示例传递两个字符串，一个字符串表示要插入到表中的新值，另一个字符串用于连接至数据源。如果已插入新行，则此函数会返回新的**“Identity”**列值，如果失败，则返回 0。

Public Function AddProductCategory( _
  ByVal newName As String, ByVal connString As String) As Integer
    Dim newProdID As Int32 = 0
    Dim sql As String = _
     "INSERT INTO Production.ProductCategory (Name) VALUES (@Name); " _
       & "SELECT CAST(scope_identity() AS int);"

    Using conn As New SqlConnection(connString)
        Dim cmd As New SqlCommand(sql, conn)
        cmd.Parameters.Add("@Name", SqlDbType.VarChar)
        cmd.Parameters("@Name").Value = newName
        Try
            conn.Open()
            newProdID = Convert.ToInt32(cmd.ExecuteScalar())
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using

    Return newProdID
End Function

static public int AddProductCategory(string newName, string connString)
{
    Int32 newProdID = 0;
    string sql =
        "INSERT INTO Production.ProductCategory (Name) VALUES (@Name); "
        + "SELECT CAST(scope_identity() AS int)";
    using (SqlConnection conn = new SqlConnection(connString))
    {
        SqlCommand cmd = new SqlCommand(sql, conn);
        cmd.Parameters.Add("@Name", SqlDbType.VarChar);
        cmd.Parameters["@name"].Value = newName;
        try
        {
            conn.Open();
            newProdID = (Int32)cmd.ExecuteScalar();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
    return (int)newProdID;
}

平台

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

请参见

参考

SqlCommand 类
SqlCommand 成员
System.Data.SqlClient 命名空间

其他资源

在 ADO.NET 中连接和检索数据
使用 SQL Server .NET Framework 数据提供程序