Skip to main content

Classes de status code | API | CSharp

  • Classes de status code | API | CSharp

Código de Status (Status Code)

Resultados de Status no ASP.NET Core MVC​

Os Status Results no ASP.NET Core MVC são tipos de resultados de ação que permitem retornar códigos de status HTTP juntamente com conteúdo opcional. Existem vários tipos disponíveis, como:

  • StatusCodeResult: representa uma resposta com um código de status HTTP específico e sem conteúdo adicional.
  • NotFoundResult: representa uma resposta com o código HTTP 404 (Não Encontrado).
  • BadRequestResult: representa uma resposta com o código HTTP 400 (Requisição Inválida).
  • OkResult: representa uma resposta com o código HTTP 200 (OK).
  • UnauthorizedResult: representa uma resposta com o código HTTP 401 (Não Autorizado).

Os Status Results indicam sucesso, falha ou várias condições de erro ao cliente. Utilizando esses resultados, é possível garantir que o cliente compreenda o resultado da sua solicitação com base no código de status HTTP retornado.

Exemplo de StatusCodeResult no ASP.NET Core MVC​

using Microsoft.AspNetCore.Mvc;
namespace ActionResultInASPNETCoreMVC.Controllers
{
    public class HomeController : Controller
    {
        public IActionResult NotFoundExample()
        {
            // Retorna uma resposta 404 (Não Encontrado)
            return new StatusCodeResult(404);
        }

        public IActionResult CustomStatusCodeExample()
        {
            // Retorna um código de status personalizado
            return new StatusCodeResult(403); 
        }
    }
}

Usando o Método Helper StatusCodeResult​

using Microsoft.AspNetCore.Mvc;
namespace ActionResultInASPNETCoreMVC.Controllers
{
    public class HomeController : Controller
    {
        public StatusCodeResult NotFoundExample()
        {
            // Retorna uma resposta 404 (Não Encontrado)
            return StatusCode(404);
        }

        public IActionResult CustomStatusCodeExample()
        {
            // Retorna um código de status personalizado
            return StatusCode(403); 
        }
    }
}

Outras Classes de Resultado​

  • HttpUnauthorizedResult
  • NotFoundResult
  • OkResult