IDbCommand.ExecuteScalar Metódus

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

IDbCommand.cs

Végrehajtja a lekérdezést, és visszaadja a lekérdezés által visszaadott eredményhalmaz első sorának első oszlopát. A rendszer figyelmen kívül hagyja a további oszlopokat vagy sorokat.

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

Válaszok

Object

Az eredményhalmaz első sorának első oszlopa.

Példák

Az alábbi példa létrehozza a származtatott osztály egy példányát, SqlCommandmajd végrehajtja azt a használatával ExecuteScalar. A példa egy olyan sztringet ad át, amely egy Transact-SQL utasítás, amely összesített eredményt ad vissza, és egy olyan sztringet, amely az adatforráshoz való csatlakozáshoz használható.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

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

Megjegyzések

ExecuteScalar A metódussal egyetlen értéket (például összesített értéket) kér le egy adatbázisból. Ehhez kevesebb kód szükséges, mint a ExecuteReader metódus használata, majd az egyetlen érték létrehozásához szükséges műveletek végrehajtása a visszaadott IDataReaderadatokkal.

Egy tipikus ExecuteScalar lekérdezés a következő C#-példa szerint formázható:

CommandText = "select count(*) as NumberOfRegions from region";
Int32 count = (int) ExecuteScalar();

Ha az eredményhalmaz első sorának első oszlopa nem található, a rendszer null hivatkozást (Nothing Visual Basic) ad vissza. Ha az adatbázis értéke az null, a lekérdezés visszaadja DBNull.Value.