Ler em inglês

Compartilhar via


InputFormatterExceptionPolicy Enumeração

Definição

Define o conjunto de políticas que determinam como o sistema de associação de modelo interpreta exceções geradas por um IInputFormatter.

C#
public enum InputFormatterExceptionPolicy
Herança
InputFormatterExceptionPolicy

Campos

Nome Valor Description
AllExceptions 0

Esse valor indica que todas as exceções geradas por um IInputFormatter serão tratadas como erros de estado do modelo.

MalformedInputExceptions 1

Esse valor indica que somente InputFormatterException as subclasses e serão tratadas como erros de estado do modelo. Todos os outros tipos de exceções serão relançados e podem ser manipulados por um manipulador de exceção de nível mais alto, como middleware de tratamento de exceção.

Comentários

Um IInputFormatter pode gerar uma exceção por vários motivos, incluindo:

  • entrada malformada
  • desconectar cliente ou outro problema de E/S
  • problemas de configuração do aplicativo, como TypeLoadException

A política associada a AllExceptions trata todas essas categorias de problemas como erros de estado do modelo e geralmente será relatada ao cliente como um HTTP 400. Essa foi a única política compatível com a associação de modelo no ASP.NET Core MVC 1.0, 1.1 e 2.0 e ainda é o padrão por motivos históricos.

A política associada a MalformedInputExceptions trata apenas InputFormatterException e suas subclasses como erros de estado do modelo. Isso significa que exceções que não estão relacionadas ao conteúdo da solicitação HTTP (como uma desconexão) serão lançadas novamente, o que, por padrão, causaria uma resposta HTTP 500, a menos que haja um middleware de tratamento de exceção habilitado.

Aplica-se a

Produto Versões
ASP.NET Core 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0