DataTable.Compute(String, String) Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Quelle:

DataTable.cs

Berechnet den angegebenen Ausdruck für die aktuellen Zeilen, die die Filterkriterien erfüllen.

public:
 System::Object ^ Compute(System::String ^ expression, System::String ^ filter);

public object Compute (string? expression, string? filter);

member this.Compute : string * string -> obj

Public Function Compute (expression As String, filter As String) As Object

Parameter

expression

String

Der zu berechnende Ausdruck.

filter

String

Der Filter zum Begrenzen der Zeilen, die in dem Ausdruck ausgewertet werden.

Gibt zurück

Object

Ein Object, das auf das Ergebnis der Berechnung festgelegt ist. Wenn der Ausdruck NULL ergibt, ist der Rückgabewert Value.

Beispiele

Im folgenden Beispiel werden die Werte einer Spalte mit dem Namen "Total" für den Vertriebsmitarbeiter summiert, dessen Identifikationsnummer fünf ist.

private void ComputeBySalesSalesID(DataSet dataSet)
{
    // Presumes a DataTable named "Orders" that has a column named "Total."
    DataTable table;
    table = dataSet.Tables["Orders"];

    // Declare an object variable.
    object sumObject;
    sumObject = table.Compute("Sum(Total)", "EmpID = 5");
}

Private Sub ComputeBySalesSalesID(ByVal dataSet As DataSet)
    ' Presumes a DataTable named "Orders" that has a column named "Total."
    Dim table As DataTable
    table = dataSet.Tables("Orders")

    ' Declare an object variable.
    Dim sumObject As Object
    sumObject = table.Compute("Sum(Total)", "EmpID = 5")
 End Sub

Hinweise

Der expression Parameter erfordert eine Aggregatfunktion. Im Folgenden finden Sie beispielsweise einen rechtlichen Ausdruck:

Count(Quantity)

Dieser Ausdruck ist jedoch nicht:

Sum (Quantity * UnitPrice)

Wenn Sie einen Vorgang für zwei oder mehr Spalten ausführen müssen, sollten Sie einen DataColumnerstellen, dessen Expression Eigenschaft auf einen geeigneten Ausdruck festlegen und einen Aggregatausdruck für die resultierende Spalte verwenden. Geben Sie in diesem Fall ein DataColumn mit dem Namen "total" und die Expression -Eigenschaft auf folgendes festgelegt:

"Quantity * UnitPrice"

Das Ausdrucksargument für die Compute -Methode lautet dann wie folgt:

Sum(total)

Der zweite Parameter bestimmt filter, welche Zeilen im Ausdruck verwendet werden. Wenn die Tabelle beispielsweise eine Datumsspalte mit dem Namen "colDate" enthält, können Sie die Zeilen mit dem folgenden Ausdruck einschränken:

colDate > 1/1/99 AND colDate < 17/1/99

Regeln zum Erstellen von Ausdrücken für beide Parameter finden Sie in der DataColumn.Expression -Eigenschaft.

Weitere Informationen

• "DataTables"