DataTable.Compute(String, String) Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataTable.cs

Calcule l'expression donnée sur les lignes en cours qui passent les critères du filtre.

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

Paramètres

expression

String

Expression à calculer.

filter

String

Filtre permettant de limiter le nombre de lignes dont le résultat de l'évaluation est contenu dans l'expression.

Retours

Object

Object ayant pour valeur le résultat du calcul. Si l'expression prend la valeur Null, la valeur de retour est Value.

Exemples

L’exemple suivant additionne les valeurs d’une colonne nommée « Total », pour le vendeur dont le numéro d’identification est cinq.

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

Remarques

Le expression paramètre nécessite une fonction d’agrégation. Par exemple, voici une expression juridique :

Count(Quantity)

Mais cette expression n’est pas :

Sum (Quantity * UnitPrice)

Si vous devez effectuer une opération sur deux colonnes ou plus, vous devez créer un DataColumn, définir sa Expression propriété sur une expression appropriée et utiliser une expression d’agrégation sur la colonne résultante. Dans ce cas, donnez un DataColumn avec le nom « total » et la Expression propriété définie sur ceci :

"Quantity * UnitPrice"

L’argument d’expression de la Compute méthode serait alors le suivant :

Sum(total)

Le deuxième paramètre, filter, détermine les lignes utilisées dans l’expression. Par exemple, si la table contient une colonne de date nommée « colDate », vous pouvez limiter les lignes avec l’expression suivante :

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

Pour connaître les règles de création d’expressions pour les deux paramètres, consultez la DataColumn.Expression propriété .

Voir aussi

• DataTables