DataTable.Compute(String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Calcule l’expression donnée sur les lignes actuelles qui passent les critères de filtre.
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);
public object Compute(string? expression, string? filter);
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
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 pour limiter les lignes évaluées dans l’expression.
Retours
Valeur Object, définie sur le résultat du calcul. Si l’expression prend la valeur Null, la valeur de retour est Value.
- Attributs
Exemples
L’exemple suivant additionne les valeurs d’une colonne nommée « Total », pour l’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 légale :
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 une DataColumnpropriété , 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, étant donné le DataColumn nom « total » et la Expression propriété définie sur ceci :
"Quantity * UnitPrice"
L’argument d’expression de la Compute méthode est alors le suivant :
Sum(total)
Le deuxième paramètre, filterdé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é.