OleDbCommand.ExecuteScalar Metoda

  • Reference

Definice

Obor názvů:
System.Data.OleDb
Sestavení:
System.Data.OleDb.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.OleDb v8.0.1
Balíček:
System.Data.OleDb v9.0.0-rc.2.24473.5
Zdroj:
OleDbCommand.cs
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ů dotazu vrácené dotazem. Další sloupce nebo řádky jsou ignorovány.

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ů 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();

Platí pro

Viz také