Contar filas mediante FetchXml

Utilice el atributo elemento de búsqueda booleano returntotalrecordcount para especificar que el resultado incluya un recuento de todos los registros que cumplen con los criterios del filtro, hasta 5000. Utilícelo cuando recupere resultados paginados para estimar el número total de páginas que se mostrarán.

No puede aplicar el atributo elemento de búsqueda top junto con returntotalrecordcount.

El comportamiento que puede esperar depende de si utiliza el SDK para .NET o la web API.

SDK para .NET

Cuando el valor del atributo returntotalrecordcount es true, el EntityCollection devuelto por el método RetrieveMultiple incluye valores para las siguientes propiedades:

Propiedad	Descripción
TotalRecordCount	El número total de registros hasta 5000; de lo contrario, el valor es -1.
TotalRecordCountLimitExceeded	true si los resultados de la consulta exceden el recuento total de registros; de lo contrario, false.

API web

Establecer el valor del atributo returntotalrecordcount en true tiene el mismo resultado que configurar la opción de consulta OData $count . Puede agregar &$count=true a su consulta de FetchXml para obtener los mismos resultados. Obtenga más información sobre la opción de consulta $count de OData.

Cuando configure el atributo returntotalrecordcount (o utilice la opción de consulta$count) los datos devueltos incluirán la anotación @odata.count con el número total de registros que coinciden con los criterios del filtro, hasta 5000.

Si incluye cualquiera de estos encabezados de solicitud:

Prefer: odata.include-annotations="Microsoft.Dynamics.CRM.totalrecordcount,Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded"
   OR for all annotations:
Prefer: odata.include-annotations="*"

Se devolverán las siguientes anotaciones:

Propiedad	Descripción
@Microsoft.Dynamics.CRM.totalrecordcount	El número total de registros hasta 5000; de lo contrario, el valor es -1. El valor es el mismo que la anotación @odata.count.
@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded	true si los resultados de la consulta exceden el recuento total de registros; de lo contrario, false.

El valor (TotalRecordCountLimitExceeded o @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) es útil cuando necesita calcular cuántas solicitudes paginadas más necesita enviar para obtener todos los resultados cuando (TotalRecordCount o @Microsoft.Dynamics.CRM.totalrecordcount) es igual a 5000.

Si el tamaño de su página es menor que el máximo y (TotalRecordCount o @Microsoft.Dynamics.CRM.totalrecordcount) es igual o menor que 5000, puede calcular cuántas solicitudes paginadas más debe enviar para obtener todos los registros.

Cuando (TotalRecordCountLimitExceeded o @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) es true y (TotalRecordCount o @Microsoft.Dynamics.CRM.totalrecordcount) es igual a 5000, no puede realizar este cálculo.

Sugerencia

Si desea obtener un recuento total de registros sin filtro, use el mensaje RetrieveTotalRecordCount con la API web función RetrieveTotalRecordCount o con la clase de SDK para .NET RetrieveTotalRecordCountRequest. Los datos recuperados serán de una instantánea dentro de las últimas 24 horas.

Pasos siguientes

Aprenda a optimizar el rendimiento.

Optimizar el rendimiento

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).