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 Verkäufer 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. So ist z. B. ein rechtlicher 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 eine DataColumnerstellen, dessen Eigenschaft auf einen entsprechenden Ausdruck festlegen Expression und einen Aggregatausdruck für die resultierende Spalte verwenden. Geben Sie in diesem Fall einen DataColumn mit dem Namen "total" ein, und die Expression Eigenschaft ist auf folgendes festgelegt:

"Quantity * UnitPrice"

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

Sum(total)

Der zweite Parameter bestimmt, filterwelche 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"