Partilhar 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.

public enum class InputFormatterExceptionPolicy
public enum InputFormatterExceptionPolicy
type InputFormatterExceptionPolicy = 
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