Results Classe

Referência

Definição

Namespace:: Microsoft.AspNetCore.Http

Assembly:: Microsoft.AspNetCore.Http.Results.dll

Pacote:: Microsoft.AspNetCore.App.Ref v6.0.6

Pacote:: Microsoft.AspNetCore.App.Ref v7.0.5

Pacote:: Microsoft.AspNetCore.App.Ref v8.0.0

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Uma fábrica para IResult.

public static class Results

type Results = class

Public Class Results

Herança: Object
Results

Propriedades

Empty	Produz uma resposta de resultado vazia, que quando executada não fará nada.
Extensions	Fornece um contêiner para bibliotecas externas estenderem o conjunto padrão `Results` com seus próprios exemplos.

Métodos

Accepted(String, Object)	Produz uma Status202Accepted resposta.
Accepted<TValue>(String, TValue)	Produz uma Status202Accepted resposta.
AcceptedAtRoute(String, Object, Object)	Produz uma Status202Accepted resposta.
AcceptedAtRoute(String, RouteValueDictionary, Object)	Produz uma Status202Accepted resposta.
AcceptedAtRoute<TValue>(String, Object, TValue)	Produz uma Status202Accepted resposta.
AcceptedAtRoute<TValue>(String, RouteValueDictionary, TValue)	Produz uma Status202Accepted resposta.
BadRequest(Object)	Produz uma Status400BadRequest resposta.
BadRequest<TValue>(TValue)	Produz uma Status400BadRequest resposta.
Bytes(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)	Grava o conteúdo da matriz de bytes na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável). Essa API é um alias para File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue).
Bytes(ReadOnlyMemory<Byte>, String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)	Grava o conteúdo da matriz de bytes na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
Challenge(AuthenticationProperties, IList<String>)	Cria um IResult que na execução invoca ChallengeAsync(HttpContext, String, AuthenticationProperties). O comportamento desse método depende do IAuthenticationService em uso. Status401Unauthorizede Status403Forbidden estão entre os resultados prováveis status.
Conflict(Object)	Produz uma Status409Conflict resposta.
Conflict<TValue>(TValue)	Produz uma Status409Conflict resposta.
Content(String, MediaTypeHeaderValue)	Grava a cadeia `content` de caracteres na resposta HTTP.
Content(String, String, Encoding)	Grava a cadeia `content` de caracteres na resposta HTTP. Isso é equivalente a Text(String, String, Encoding).
Content(String, String, Encoding, Nullable<Int32>)	Grava a cadeia `content` de caracteres na resposta HTTP. Isso é equivalente a Text(String, String, Encoding, Nullable<Int32>).
Created()	Produz uma Status201Created resposta.
Created(String, Object)	Produz uma Status201Created resposta.
Created(Uri, Object)	Produz uma Status201Created resposta.
Created<TValue>(String, TValue)	Produz uma Status201Created resposta.
Created<TValue>(Uri, TValue)	Produz uma Status201Created resposta.
CreatedAtRoute(String, Object, Object)	Produz uma Status201Created resposta.
CreatedAtRoute(String, RouteValueDictionary, Object)	Produz uma Status201Created resposta.
CreatedAtRoute<TValue>(String, Object, TValue)	Produz uma Status201Created resposta.
CreatedAtRoute<TValue>(String, RouteValueDictionary, TValue)	Produz uma Status201Created resposta.
File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)	Grava o conteúdo da matriz de bytes na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável). Essa API é um alias para Bytes(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue).
File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	Grava o especificado Stream na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável). Essa API é um alias para Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean).
File(String, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	Grava o arquivo no especificado `path` na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
Forbid(AuthenticationProperties, IList<String>)	Cria um IResult que na execução invoca ForbidAsync(HttpContext, String, AuthenticationProperties). Por padrão, a execução desse resultado retorna um Status403Forbidden. Alguns esquemas de autenticação, como cookies, serão convertidos Status403Forbidden em um redirecionamento para mostrar uma página de logon.
Json(Object, JsonSerializerOptions, String, Nullable<Int32>)	Cria um IResult que serializa o objeto especificado `data` para JSON.
Json(Object, JsonTypeInfo, String, Nullable<Int32>)	Cria um IResult que serializa o objeto especificado `data` para JSON.
Json(Object, Type, JsonSerializerContext, String, Nullable<Int32>)	Cria um IResult que serializa o objeto especificado `data` para JSON.
Json<TValue>(TValue, JsonSerializerContext, String, Nullable<Int32>)	Cria um IResult que serializa o objeto especificado `data` para JSON.
Json<TValue>(TValue, JsonSerializerOptions, String, Nullable<Int32>)	Cria um IResult que serializa o objeto especificado `data` para JSON.
Json<TValue>(TValue, JsonTypeInfo<TValue>, String, Nullable<Int32>)	Cria um IResult que serializa o objeto especificado `data` para JSON.
LocalRedirect(String, Boolean, Boolean)	Redireciona para o especificado `localUrl`. Quando `permanent` e `preserveMethod` são definidos, define o Status308PermanentRedirect código status. Quando `preserveMethod` é definido, define o Status307TemporaryRedirect código status. Quando `permanent` é definido, define o Status301MovedPermanently código status. Caso contrário, configura Status302Found.
NoContent()	Produz uma Status204NoContent resposta.
NotFound(Object)	Produz uma Status404NotFound resposta.
NotFound<TValue>(TValue)	Produz uma Status404NotFound resposta.
Ok(Object)	Produz uma Status200OK resposta.
Ok<TValue>(TValue)	Produz uma Status200OK resposta.
Problem(ProblemDetails)	Produz uma ProblemDetails resposta.
Problem(String, String, Nullable<Int32>, String, String, IDictionary<String,Object>)	Produz uma ProblemDetails resposta.
Redirect(String, Boolean, Boolean)	Redireciona para o especificado `url`. Quando `permanent` e `preserveMethod` são definidos, define o Status308PermanentRedirect código status. Quando `preserveMethod` é definido, define o Status307TemporaryRedirect código status. Quando `permanent` é definido, define o Status301MovedPermanently código status. Caso contrário, configura Status302Found.
RedirectToRoute(String, Object, Boolean, Boolean, String)	Redireciona para a rota especificada. Quando `permanent` e `preserveMethod` são definidos, define o Status308PermanentRedirect código status. Quando `preserveMethod` é definido, define o Status307TemporaryRedirect código status. Quando `permanent` é definido, define o Status301MovedPermanently código status. Caso contrário, configura Status302Found.
RedirectToRoute(String, RouteValueDictionary, Boolean, Boolean, String)	Redireciona para a rota especificada. Quando `permanent` e `preserveMethod` são definidos, define o Status308PermanentRedirect código status. Quando `preserveMethod` é definido, define o Status307TemporaryRedirect código status. Quando `permanent` é definido, define o Status301MovedPermanently código status. Caso contrário, configura Status302Found.
SignIn(ClaimsPrincipal, AuthenticationProperties, String)	Cria um IResult que na execução invoca SignInAsync(HttpContext, String, ClaimsPrincipal, AuthenticationProperties).
SignOut(AuthenticationProperties, IList<String>)	Cria um IResult que na execução invoca SignOutAsync(HttpContext, String, AuthenticationProperties).
StatusCode(Int32)	Cria um IResult objeto especificando um `statusCode`.
Stream(Func<Stream,Task>, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue)	Permite gravar diretamente no corpo da resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
Stream(PipeReader, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	Grava o conteúdo de especificado PipeReader na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável).
Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	Grava o especificado Stream na resposta. Isso dá suporte a solicitações de intervalo (Status206PartialContent ou Status416RangeNotSatisfiable se o intervalo não for satisfiável). Essa API é um alias para File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean).
Text(ReadOnlySpan<Byte>, String, Nullable<Int32>)	Grava o `utf8Content` texto codificado em UTF-8 na resposta HTTP.
Text(String, String, Encoding)	Grava a cadeia `content` de caracteres na resposta HTTP. Este é um alias para Content(String, String, Encoding).
Text(String, String, Encoding, Nullable<Int32>)	Grava a cadeia `content` de caracteres na resposta HTTP. Este é um alias para Content(String, String, Encoding, Nullable<Int32>).
Unauthorized()	Produz uma Status401Unauthorized resposta.
UnprocessableEntity(Object)	Produz uma Status422UnprocessableEntity resposta.
UnprocessableEntity<TValue>(TValue)	Produz uma Status422UnprocessableEntity resposta.
ValidationProblem(IDictionary<String,String[]>, String, String, Nullable<Int32>, String, String, IDictionary<String,Object>)	Produz uma Status400BadRequest resposta com um HttpValidationProblemDetails valor .

Aplica-se a