DataTable.Compute(String, String) Methode

Definition

Namespace:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Quelle:

DataTable.cs

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

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter or expression might be trimmed.")]
public object Compute(string? expression, string? filter);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter or expression might be trimmed.")>]
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, um die Zeilen einzuschränken, die im Ausdruck ausgewertet werden.

Gibt zurück

Object

Ein Object, wird auf das Ergebnis der Berechnung festgelegt. Wenn der Ausdruck als NULL ausgewertet wird, lautet Valueder Rückgabewert .

Attribute

RequiresUnreferencedCodeAttribute

Beispiele

Im folgenden Beispiel werden die Werte einer Spalte mit dem Namen "Total" für den Verkäufer addiert, 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. Dies ist beispielsweise 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 DataColumnEigenschaft erstellen, dessen Expression Eigenschaft auf einen geeigneten Ausdruck festlegen und einen Aggregatausdruck für die resultierende Spalte verwenden. In diesem Fall wird ein DataColumn Wert 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, 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