Add `ExceptionHandlerOptions.SuppressLoggingOnHandledException`

[JamesNK]

Background and Motivation

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

For #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]

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.

[mitchdenny]

This seems reasonable to me in terms of the feature. Naming wise ... Suppress vs. Disable vs. Other options. I'm assuming you are using a negative property name because you want the default value to be false?

[JamesNK]

Yes. Suppress is common in our APIs: https://learn.microsoft.com/en-us/dotnet/api/?view=aspnetcore-9.0&term=Suppress