IQueryResultT

IQueryResultT is a generic interface intended to represent the outcome of performing a query whose resulting elements are of type T. The interface is designed to encapsulate both the retrieved data and accompanying metadata in a consistent, library-agnostic form, enabling callers to handle results from various data sources such as databases, services, or in-memory collections.

Typical members and responsibilities include a collection of results (often named Items, Results, or Value), and related metadata such as TotalCount for paging, PageIndex and PageSize, and HasMore to indicate if additional pages exist. It commonly exposes status information, such as IsSuccess, along with optional error details like ErrorCode and ErrorMessage. Additional diagnostic or performance data, such as QueryTime, may be included to aid debugging and monitoring. In many designs, IQueryResultT is intended to be immutable once constructed, to simplify usage and testing.

Usage patterns involve invoking a query operation and inspecting the returned IQueryResultT<T>. Callers typically check IsSuccess, iterate over Items for the actual data, and use paging metadata to drive user interfaces or further queries. If IsSuccess is false, the ErrorMessage (and possibly ErrorCode) informs error handling routines.

Design considerations for IQueryResultT include consistency across different data sources, clear separation between data and metadata, and support for both synchronous and asynchronous query flows. It is often paired with non-generic result wrappers for convenience or with additional interfaces that specialize metadata or pagination behavior.