OleDbCommand.ExecuteScalar Metod

Definition

Namnområde:
System.Data.OleDb
Sammansättning:
System.Data.OleDb.dll
Sammansättning:
System.Data.dll
Paket:
System.Data.OleDb v11.0.0-preview.4.26230.115
Källa:
OleDbCommand.cs
Källa:
OleDbCommand.cs
Källa:
OleDbCommand.cs
Källa:
OleDbCommand.cs

Kör frågan och returnerar den första kolumnen i den första raden i resultatuppsättningen som returneras av frågan. Ytterligare kolumner eller rader ignoreras.

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

Returer

Object

Den första kolumnen på den första raden i resultatuppsättningen eller en null-referens om resultatuppsättningen är tom.

Implementeringar

ExecuteScalar()

Undantag

InvalidOperationException

Det går inte att köra ett kommando i en transaktionskontext som skiljer sig från den kontext där anslutningen ursprungligen registrerades.

Exempel

I följande exempel skapas en OleDbCommand och körs sedan med hjälp av ExecuteScalar. Exemplet skickas en sträng som är en SQL-instruktion som returnerar ett aggregerat resultat och en sträng som ska användas för att ansluta till datakällan.

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

Kommentarer

ExecuteScalar Använd metoden för att hämta ett enda värde, till exempel ett aggregeringsvärde, från en datakälla. Detta kräver mindre kod än att använda ExecuteReader metoden och sedan utföra de åtgärder som krävs för att generera det enskilda värdet med hjälp av data som returneras av en OleDbDataReader.

En typisk ExecuteScalar fråga kan formateras som i följande C#-exempel:

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

Gäller för

Se även