SqlCommand.ExecuteScalar Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácených dotazem. Další sloupce nebo řádky se ignorují.

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

public override object ExecuteScalar();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Návraty

Object

První sloupec prvního řádku v sadě výsledků nebo nulový odkaz (Nothing v Visual Basic), pokud je sada výsledků prázdná. Vrátí maximálně 2033 znaků.

Výjimky

InvalidCastException

SqlDbType Jiný než Binary nebo VarBinary byl použit při Value nastavení Stream. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

nebo

SqlDbType Jiná hodnota než Char, NChar, NVarChar, VarChar nebo Xml byla použita při Value nastavení TextReader.

nebo

SqlDbType Jiná než Xml byla použita při Value nastavení na XmlReaderhodnotu .

SqlException

Při provádění příkazu na uzamčený řádek došlo k výjimce. Tato výjimka není generována při použití rozhraní Microsoft .NET Framework verze 1.0.

nebo

Během operace streamování došlo k vypršení časového limitu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

InvalidOperationException

Zavřený SqlConnection nebo ukončený během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

IOException

Během operace streamování došlo k chybě nebo StreamXmlReaderTextReader objektu. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

ObjectDisposedException

Stream Objekt XmlReadernebo TextReader objekt byl uzavřen během operace streamování. Další informace o streamování najdete v tématu Podpora streamování SqlClient.

Příklady

Následující příklad vytvoří SqlCommand a pak ji spustí pomocí ExecuteScalar. Příklad je předán řetězec představující novou hodnotu, která se má vložit do tabulky, a řetězec, který se má použít pro připojení ke zdroji dat. Funkce vrátí novou hodnotu sloupce Identity , pokud byl vložen nový řádek, 0 při selhání.

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

Poznámky

Použijte metodu ExecuteScalar k načtení jedné hodnoty (například agregační hodnoty) z databáze. To vyžaduje méně kódu než použití ExecuteReader metody a provádění operací, které potřebujete vygenerovat jednu hodnotu pomocí dat vrácených SqlDataReaderfunkcí .

Typický ExecuteScalar dotaz je možné naformátovat jako v následujícím příkladu jazyka C#:

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

Viz také

• Připojení a načítání dat v ADO.NET
• Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
• Přehled ADO.NET