Add option to exception handler middleware to not log error

[JamesNK]

Fixes #54554

Background

Exception handler middleware handles exceptions thrown in the app. There are various mechanisms for handling an exception:

• Registered IExceptionHandler instances. Return true to indicate exception is handled.
• Registered IProblemDetailsService instance. Return true to indicate exception is handled.
• Configured ExceptionHandlerOptions.ExceptionHandler delegate.
• Configured ExceptionHandlerOptions.StatusCodeSelector delegate.

If the exception is handled then the middleware invoke returns without rethrowing the exception. Unhandled exceptions are rethrown back into the middleware pipeline.

Problem

Today the exception handle middleware always writes the UnhandledException log message (skipped if the exception is related to the request being aborted). I think the idea here is the exception handler received an unhandled error. The problem is it is logged at an Error level, and customers who automatically log all Error level logs could get a potentially unwanted error the message.

The request from users is to only write the UnhandledException log message if the exception handler didn't handle the exception. That stops the error level UnhandledException log message from being logged.

Fix

The PR adds a new option to the exception handler, ExceptionHandlerOptions.SuppressLoggingOnHandledException (final name TBD). It keeps the current behavior but gives an option to opt-in to only logging the unhandled exception log message if the middleware didn't handle the exception.

[JamesNK]

Product changes ready to review. Tests coming.

[JamesNK]

API review: #59075