SqlCommand.ExecuteScalar 方法

定义

命名空间:
System.Data.SqlClient
程序集:
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

结果集中第一行的第一列;如果结果集为空，则为空引用（Nothing in Visual Basic）。 返回最多 2033 个字符。

实现

ExecuteScalar()

例外

InvalidCastException

如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

设置为 /a0> 时使用了除 Char、NChar、NVarChar、VarChar 或 Xml 以外的其他项。

-或-

设置为SqlDbType时使用了 ValueXmlReader项。

SqlException

针对锁定行执行命令时发生异常。 使用 Microsoft .NET Framework 版本 1.0 时，不会生成此异常。

-或-

流式处理操作期间发生超时。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

InvalidOperationException

在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

ObjectDisposedException

Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

示例

以下示例创建一个并使用 /&a0> 执行它 。 该示例传递了一个字符串，表示要插入表中的新值，以及一个用于连接到数据源的字符串。 如果插入了新行，则此函数返回新的 Identity 列值，失败时为 0。

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;
}

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

注解

ExecuteScalar使用该方法从数据库检索单个值（例如聚合值）。 这需要的代码少于使用 ExecuteReader 方法，然后执行需要使用 a SqlDataReader返回的数据生成单个值的操作。

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

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

适用于

另请参阅