Add `ExceptionHandlerOptions.SuppressLoggingOnHandledException`

[JamesNK]

Background and Motivation

A config option to only log in exception handler middleware if the exception is unhandled.

For https://github.com/dotnet/aspnetcore/issues/54554

Proposed API

namespace Microsoft.AspNetCore.Builder;

public class ExceptionHandlerOptions
{
+    public bool SuppressLoggingOnHandledException { get; set; }
}

Defaults to false.

Usage Examples

app.UseExceptionHandler(new ExceptionHandlerOptions()
{
    SuppressLoggingOnHandledException = true
});

Alternative Designs

Could make the new behavior the default. I don't think that is a good idea for backwards compatibility reasons, and some people might prefer the current behavior.

Risks

[dotnet-policy-service[bot]]

Thank you for submitting this for API review. This will be reviewed by @dotnet/aspnet-api-review at the next meeting of the ASP.NET Core API Review group. Please ensure you take a look at the API review process documentation and ensure that:

• The PR contains changes to the reference-assembly that describe the API change. Or, you have included a snippet of reference-assembly-style code that illustrates the API change.
• The PR describes the impact to users, both positive (useful new APIs) and negative (breaking changes).
• Someone is assigned to "champion" this change in the meeting, and they understand the impact and design of the change.