OleDbCommand.ExecuteScalar Metoda

Definice

Obor názvů:
System.Data.OleDb
Sestavení:
System.Data.OleDb.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.OleDb v11.0.0-preview.4.26230.115
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs
Zdroj:
OleDbCommand.cs

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:
 virtual System::Object ^ ExecuteScalar();
public override object? ExecuteScalar();
public object ExecuteScalar();
public override object ExecuteScalar();
override this.ExecuteScalar : unit -> obj
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Overrides Function ExecuteScalar () As Object
Public Function ExecuteScalar () As Object

Návraty

Object

První sloupec prvního řádku v sadě výsledků nebo nulový odkaz, pokud je sada výsledků 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 se předá řetězci, který je příkazem SQL, který vrací agregovaný výsledek, a řetězec, který se použije 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

Použijte metodu ExecuteScalar k načtení jedné hodnoty, například agregační hodnoty ze zdroje dat. To vyžaduje méně kódu než použití ExecuteReader metody a provádění operací, které jsou nutné k vygenerování jedné hodnoty pomocí dat vrácených metodou 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();

Platí pro

Viz také