SqlCommand.ExecuteScalar-Methode

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Function ExecuteScalar As Object
'Usage
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

Rückgabewert

Die erste Spalte der ersten Zeile im Resultset oder ein NULL-Verweis, wenn das Resultset leer ist.

Ausnahmen

Hinweise

Mit der ExecuteScalar-Methode können Sie einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank abrufen. Dafür ist weniger Code erforderlich, als wenn Sie die ExecuteReader-Methode verwenden und anschließend die Operationen ausführen würden, die für das Generieren des einzelnen Werts mithilfe der durch einen SqlDataReader zurückgegebenen Daten erforderlich sind.

Eine normale ExecuteScalar-Abfrage kann wie im folgenden C#-Beispiel formatiert werden:

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

Beispiel

Im folgenden Beispiel wird ein SqlCommand erstellt und dieser anschließend mit ExecuteScalar ausgeführt. Diesem Beispiel wird eine Zeichenfolge übergeben, die einen neuen, in eine Tabelle einzufügenden Wert darstellt. Außerdem wird eine weitere Zeichenfolge übergeben, mit der die Verbindung mit der Datenquelle hergestellt wird. Die Funktion gibt den neuen Wert in der Spalte Identity zurück, wenn eine neue Zeile eingefügt wurde, 0, wenn der Vorgang fehlgeschlagen ist.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlCommand-Klasse
SqlCommand-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server