OleDbCommand.ExecuteScalar Metoda

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v9.0.0-preview.3.24172.9

Zdroj:

OleDbCommand.cs

Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vrácené dotazem. Další sloupce nebo řádky jsou ignorovány.

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ů dotazu nebo nulový odkaz, pokud je sada výsledků dotazu prázdná.

Implementuje

ExecuteScalar()

Výjimky

InvalidOperationException

Nelze spustit příkaz v kontextu transakce, který se liší od kontextu, ve kterém bylo připojení původně zařazeno.

Příklady

Následující příklad vytvoří OleDbCommand a pak ho spustí pomocí ExecuteScalar. Příklad je předán řetězec, který je příkazem SQL, který vrací agregovaný výsledek, a řetězec pro připojení ke zdroji dat.

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

Poznámky

Metoda slouží ExecuteScalar k načtení jedné hodnoty, například agregované hodnoty, ze zdroje dat. To vyžaduje méně kódu než použití ExecuteReader metody a následné provedení operací potřebných k vygenerování jedné hodnoty pomocí dat vrácených objektem OleDbDataReader.

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

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

Viz také

• Práce s příkazy