DataTable.Compute(String, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Calcula la expresión dada de las filas actuales que cumplen los criterios de filtro.
public:
System::Object ^ Compute(System::String ^ expression, System::String ^ filter);
public object Compute (string? expression, 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
Parámetros
- expression
- String
Expresión que se va a calcular.
- filter
- String
Filtro que va a limitar las filas que se evalúan en la expresión.
Devoluciones
Object establecido en el resultado del cálculo. Si la expresión se evalúa como null, el valor devuelto será Value.
Ejemplos
En el ejemplo siguiente se suman los valores de una columna denominada "Total", para el vendedor cuyo número de identificación es cinco.
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
Comentarios
El expression
parámetro requiere una función de agregado. Por ejemplo, lo siguiente es una expresión legal:
Count(Quantity)
Pero esta expresión no es:
Sum (Quantity * UnitPrice)
Si debe realizar una operación en dos o más columnas, debe crear un DataColumn, establecer su Expression propiedad en una expresión adecuada y usar una expresión de agregado en la columna resultante. En ese caso, dado un DataColumn elemento con el nombre "total" y la Expression propiedad establecida en esto:
"Quantity * UnitPrice"
El argumento de expresión para el Compute método sería el siguiente:
Sum(total)
El segundo parámetro, filter
, determina qué filas se usan en la expresión. Por ejemplo, si la tabla contiene una columna de fecha denominada "colDate", podría limitar las filas con la expresión siguiente:
colDate > 1/1/99 AND colDate < 17/1/99
Para conocer las reglas sobre la creación de expresiones para ambos parámetros, consulte la DataColumn.Expression propiedad .