Usar la clase QueryExpression
En Microsoft Dataverse puede usar la clase QueryExpression para construir consultas complejas para su uso con el IOrganizationService.RetrieveMultiple el método o el mensaje RetrieveMultipleRequest. Se pueden configurar los parámetros de la consulta en QueryExpression con las clases ConditionExpression, ColumnSet y FilterExpression.
La clase QueryExpression permite crear consultas complejas. La clase QueryByAttribute está diseñada para ser un instrumento sencillo para buscar filas de tabla en las que las columnas coinciden con los valores especificados.
Recuento de registros
Para averiguar cuántos registros devuelve la consulta, establezca la propiedad ReturnTotalRecordCount en true antes de ejecutar la consulta. Al hacerlo, se establecerá TotalRecordCount. De lo contrario, este valor es -1.
Ejemplo
En el siguiente ejemplo se muestra cómo usar la clase QueryExpression.
// Query using ConditionExpression and FilterExpression
ConditionExpression condition1 = new ConditionExpression();
condition1.AttributeName = "lastname";
condition1.Operator = ConditionOperator.Equal;
condition1.Values.Add("Brown");
FilterExpression filter1 = new FilterExpression();
filter1.Conditions.Add(condition1);
QueryExpression query = new QueryExpression("contact");
query.ColumnSet.AddColumns("firstname", "lastname");
query.Criteria.AddFilter(filter1);
EntityCollection result1 = _serviceProxy.RetrieveMultiple(query);
Console.WriteLine();Console.WriteLine("Query using Query Expression with ConditionExpression and FilterExpression");
Console.WriteLine("---------------------------------------");
foreach (var a in result1.Entities)
{
Console.WriteLine("Name: " + a.Attributes["firstname"] + " " + a.Attributes["lastname"]);
}
Console.WriteLine("---------------------------------------");
Usar sugerencias en una consulta SQL
La clase QueryExpression contiene una propiedad denominada QueryHints. Al establecer esta propiedad en uno de los valores de cadena admitidos que se muestran a continuación, puede proporcionar una pista para el texto SQL generado que afecta la ejecución de la consulta.
| Valor de QueryHint | Opción y consulta de SQL Query |
|---|---|
| OptimizeForUnknown | Optimizar para desconocido |
| ForceOrder | Forzar orden |
| DisableRowGoal | use hint('Disable_Optimizer_RowGoal') |
| EnableOptimizerHotfixes | use hint('ENABLE_QUERY_OPTIMIZER_HOTFIXES') |
| LoopJoin | Combinación de bucle |
| MergeJoin | Combinación de mezcla |
| HashJoin | Combinación hash |
| NO_PERFORMANCE_SPOOL | NO_PERFORMANCE_SPOOL |
| MaxRecursion | Número MAXRECURSION |
| ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS | ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS |
Más información: Sugerencias (Transact-SQL) - Consulta
Consultar también
Generar consultas con QueryExpression
Utilizar la clase ColumnSet
Uso de la clase ConditionExpression
Usar la clase FilterExpression
QueryExpression
Nota
¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)
La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).