[DataGrid] Make EntityFrameworkAsyncQueryExecutor inheritable

src/Extensions/DataGrid.EntityFrameworkAdapter/EntityFrameworkAsyncQueryExecutor.cs

@@ -1,23 +1,34 @@
+// ------------------------------------------------------------------------
+// MIT License - Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------
+
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Query;
 using Microsoft.FluentUI.AspNetCore.Components.DataGrid.Infrastructure;
 
 namespace Microsoft.FluentUI.AspNetCore.Components.DataGrid.EntityFrameworkAdapter;
 
-internal class EntityFrameworkAsyncQueryExecutor : IAsyncQueryExecutor, IDisposable
+/// <summary>
+/// An <see cref="IAsyncQueryExecutor"/> implementation for Entity Framework Core.
+/// </summary>
+public class EntityFrameworkAsyncQueryExecutor : IAsyncQueryExecutor, IDisposable
 {
     private readonly SemaphoreSlim _lock = new(1);
 
+    /// <inheritdoc />
     public bool IsSupported<T>(IQueryable<T> queryable)
         => queryable.Provider is IAsyncQueryProvider;
 
+    /// <inheritdoc />
     public Task<int> CountAsync<T>(IQueryable<T> queryable, CancellationToken cancellationToken)
         => ExecuteAsync(() => queryable.CountAsync(cancellationToken));
 
+    /// <inheritdoc />
     public Task<T[]> ToArrayAsync<T>(IQueryable<T> queryable, CancellationToken cancellationToken)
         => ExecuteAsync(() => queryable.ToArrayAsync(cancellationToken));
 
-    private async Task<TResult> ExecuteAsync<TResult>(Func<Task<TResult>> operation)
+    /// <inheritdoc />
+    protected virtual async Task<TResult> ExecuteAsync<TResult>(Func<Task<TResult>> operation)
     {
         try
         {

src/Extensions/DataGrid.EntityFrameworkAdapter/README.md

@@ -29,12 +29,25 @@ Install the package by running the command:
 dotnet add package Microsoft.FluentUI.AspNetCore.Components.DataGrid.EntityFrameworkAdapter
 ```
 
+## Creating a derived AsyncQueryExecutor implementation
+Starting with v4.11.4, the `EntityFrameworkAsyncQueryExecutor` class is made public
+so that you can derive from it and override the `ExecuteAsync` method to provide
+custom query execution logic. This is useful if you want to add custom query processing
+logic, such as logging, caching, or query translation or if you want specific [error handling](https://github.com/microsoft/fluentui-blazor/issues/3269).
+
 ## Usage
-In your Program.cs file you need to add the following:
+When using the provided implementation, you need to add add the following in the `Program.cs` file:
+
 ```
 builder.Services.AddDataGridEntityFrameworkAdapter();
 ```
 
+When using a custom implementation, you need to add this custom implementation to the DI container in the `Program.cs` file yourself.
+You do **not** call `AddDataGridEntityFrameworkAdapter` in this case.
+```
+builder.Services.AddScoped<IAsyncQueryExecutor, MyCustomAsyncQueryExecutor>();
+```
+
 ## Support
 The Microsoft Fluent UI Blazor library is an open source project and is **not** an official part of ASP.NET Core, which means it’s **not** officially
 supported and isn’t committed to ship updates as part of any official .NET updates. It is built and maintained by Microsoft employees (**and** other contributors)