Compartir a través de

Crear consultas con QueryExpression

  • Artículo

En Microsoft Dataverse, puede usar la clase QueryExpression para crear una consulta mediante programación que contenga los filtros y las condiciones de búsqueda de los datos que definen el ámbito de una búsqueda de base de datos. Una expresión de consulta se usa para búsquedas de un solo objeto (tabla). Por ejemplo, puede crear una búsqueda que devuelva todas las cuentas que coinciden con determinados criterios de búsqueda. La clase QueryBase es la clase base para las expresiones de consulta. Hay tres clases derivadas: QueryExpression, QueryByAttribute y FetchExpression. La clase QueryExpression admite consultas complejas. La clase QueryByAttribute constituye un instrumento sencillo para buscar filas de tabla en las que las columnas coinciden con los valores especificados.

Nota

La tercera clase derivada, FetchExpression se usa con FetchXML, el lenguaje de consulta propietario Dataverse , y se puede usar para realizar algunas consultas mediante consultas basadas en XML. Más información: Consultar datos mediante FetchXML

Las expresiones de consulta se usan en métodos que recuperan más de una fila, como IOrganizationService.RetrieveMultiple método, en mensajes que realizan una operación en un conjunto de resultados especificado por una expresión de consulta, como,BulkDeleteRequest y cuando el identificador de un registro específico no se conoce.

Advertencia

No se recuperan todos las columnas en una consulta debido al efecto negativo en el rendimiento. Este valor es "true" si la consulta se usa como parámetro de una solicitud de actualización. En una actualización, si están incluidas todas las columnas, se definen todos los valores de campo, incluso si no se cambian. Con frecuencia, esto activa las actualizaciones en cascada para los registros secundarios.

Para guardar una consulta para poder reutilizarla, puede convertirla a FetchXML usando QueryExpressionToFetchXmlRequest y guardarla como una consulta guardada. Más información: Consultas guardadas

Alternativas a QueryExpression

Existen dos métodos adicionales para crear consultas para recuperar los registros de Dataverse.

Configuración de búsqueda rápida

En aplicaciones basadas en modelos hay una característica de búsqueda rápida. Si un usuario ofrece criterios de búsqueda para una búsqueda rápida que no es muy selectiva, el sistema lo detecta y se detiene la búsqueda. Esto permite un formulario más rápido de búsqueda rápida y puede suponer una gran diferencia de rendimiento. Esta es controlada por la columna QuickFindRecordLimitEnabled de entidad de la organización de la tabla de organización. Cuando este valor de la columna Boolean es true, se impone un límite de consultas de búsqueda rápida.

En esta sección

Usar la clase QueryByAttribute
Usar la clase QueryExpression
Usar la clase ColumnSet
Usar la clase ConditionExpression
Usar la clase FilterExpression
Usar una combinación externa izquierda en QueryExpression para consultar los registros "no en"
Página de conjuntos de resultados grandes con expresión de consulta y FetchXML
Ejemplo: Recuperar con relación de uno a varios
Ejemplo: Recuperar varios mediante consulta por atributo
Ejemplo: Recuperar varios mediante consulta por expresión
Ejemplo: usar QueryExpression con una cookie de paginación

Referencia

QueryBase
QueryExpression
QueryByAttribute
RetrieveMultiple
ColumnSet
ConditionExpression
FilterExpression
PagingCookie

Vea también

Ejemplo: convertir consultas entre Fetch y 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).