OleDbCommand.ExecuteScalar Methode

Definitie

Naamruimte:
System.Data.OleDb
Assembly:
System.Data.dll

Hiermee wordt de query uitgevoerd en wordt de eerste kolom van de eerste rij in de resultatenset geretourneerd door de query. Extra kolommen of rijen worden genegeerd.

public:
 virtual System::Object ^ ExecuteScalar();
public:
 override System::Object ^ ExecuteScalar();
public object ExecuteScalar();
public override object ExecuteScalar();
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object
Public Overrides Function ExecuteScalar () As Object

Retouren

Object

De eerste kolom van de eerste rij in de resultatenset of een null-verwijzing als de resultatenset leeg is.

Implementeringen

ExecuteScalar()

Uitzonderingen

InvalidOperationException

Kan een opdracht niet uitvoeren binnen een transactiecontext die verschilt van de context waarin de verbinding oorspronkelijk is opgenomen.

Voorbeelden

In het volgende voorbeeld wordt een OleDbCommand gemaakt en vervolgens uitgevoerd met behulp van ExecuteScalar. Het voorbeeld wordt doorgegeven aan een tekenreeks die een SQL-instructie is die een aggregatieresultaat retourneert en een tekenreeks die moet worden gebruikt om verbinding te maken met de gegevensbron.

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

Opmerkingen

Gebruik de ExecuteScalar methode om één waarde op te halen, bijvoorbeeld een statistische waarde, uit een gegevensbron. Hiervoor is minder code vereist dan het gebruik van de ExecuteReader methode en voert u vervolgens de bewerkingen uit die nodig zijn om de enkele waarde te genereren met behulp van de gegevens die worden geretourneerd door een OleDbDataReader.

Een typische ExecuteScalar query kan worden opgemaakt zoals in het volgende C#-voorbeeld:

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

Van toepassing op

Zie ook