OleDbCommand.ExecuteScalar Metódus

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

System.Data.OleDb v11.0.0-preview.4.26230.115

Forrás:

OleDbCommand.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:
 override System::Object ^ ExecuteScalar();

public override object? ExecuteScalar();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Válaszok

Object

Az eredményhalmaz első sorának első oszlopa, vagy null értékű hivatkozás, ha az eredményhalmaz üres.

Megvalósítás

ExecuteScalar()

Kivételek

InvalidOperationException

Nem lehet olyan parancsot végrehajtani egy tranzakciós környezetben, amely eltér attól a környezettől, amelyben a kapcsolat eredetileg szerepel.

Példák

Az alábbi példa létrehoz egy, OleDbCommand majd végrehajtja azt a használatával ExecuteScalar. A példa egy olyan sztring, amely egy SQL-utasítás, amely összesített eredményt ad vissza, és egy sztringet, amely az adatforráshoz való csatlakozáshoz használható.

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(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érdezhet le egy adatforrásbó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 OleDbDataReaderadatokkal.

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

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

Lásd még

• Parancsok használata