namespace Microsoft.AspNetCore.Builder; public class ExceptionHandlerOptions { + /// <summary> + /// Gets or sets a callback that can be used to suppress logging by <see cref="ExceptionHandlerMiddleware" />. + /// This callback is only run if the exception was handled by the middleware. + /// Unhandled exceptions and exceptions thrown after the response has started are always logged. + /// </summary> + public Func<ExceptionHandlerSuppressLoggingContext, bool>? SuppressLoggingCallback { get; set; } } namespace Microsoft.AspNetCore.Diagnostics; +/// <summary> +/// The context used to determine whether exception handler middleware should log an exception. +/// </summary> +public sealed class ExceptionHandlerSuppressLoggingContext +{ + /// <summary> + /// Gets the <see cref="System.Exception"/> that the exception handler middleware is processing. + /// </summary> + public required Exception Exception { get; init; } + + /// <summary> + /// Gets the <see cref="HttpContext"/> of the current request. + /// </summary> + public required HttpContext HttpContext { get; init; } + + /// <summary> + /// Gets the result of the exception handler middleware. + /// </summary> + public required ExceptionHandledType ExceptionHandledBy { get; init; } +} +/// <summary> +/// The result of executing <see cref="ExceptionHandlerMiddleware"/>. +/// </summary> +public enum ExceptionHandledType +{ + /// <summary> + /// Exception was unhandled. + /// </summary> + Unhandled, + /// <summary> + /// Exception was handled by an <see cref="Diagnostics.IExceptionHandler"/> instance registered in the DI container. + /// </summary> + ExceptionHandlerService, + /// <summary> + /// Exception was handled by an <see cref="Http.IProblemDetailsService"/> instance registered in the DI container. + /// </summary> + ProblemDetailsService, + /// <summary> + /// Exception was handled by by <see cref="Builder.ExceptionHandlerOptions.ExceptionHandler"/>. + /// </summary> + ExceptionHandlerCallback, + /// <summary> + /// Exception was handled by by <see cref="Builder.ExceptionHandlerOptions.ExceptionHandlingPath"/>. + /// </summary> + ExceptionHandlingPath +}