Results 類別

定義

命名空間:

Microsoft.AspNetCore.Http

組件:

Microsoft.AspNetCore.Http.Results.dll

套件:

Microsoft.AspNetCore.App.Ref v8.0.0

的 IResult 處理站。

public static class Results

type Results = class

Public Class Results

繼承

Object

Results

屬性

Empty	產生空的結果回應，當執行時不會執行任何動作。
Extensions	提供外部程式庫的容器，以使用自己的範例擴充預設 Results 集。

方法

Accepted(String, Object)	Status202Accepted產生回應。
Accepted<TValue>(String, TValue)	Status202Accepted產生回應。
AcceptedAtRoute(String, Object, Object)	Status202Accepted產生回應。
AcceptedAtRoute(String, RouteValueDictionary, Object)	Status202Accepted產生回應。
AcceptedAtRoute<TValue>(String, Object, TValue)	Status202Accepted產生回應。
AcceptedAtRoute<TValue>(String, RouteValueDictionary, TValue)	Status202Accepted產生回應。
BadRequest(Object)	Status400BadRequest產生回應。
BadRequest<TValue>(TValue)	Status400BadRequest產生回應。
Bytes(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)	將位元組陣列內容寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。 此 API 是 的 File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue) 別名。
Bytes(ReadOnlyMemory<Byte>, String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)	將位元組陣列內容寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。
Challenge(AuthenticationProperties, IList<String>)	IResult建立在執行時叫用 的 ChallengeAsync(HttpContext, String, AuthenticationProperties) 。 此方法的行為取決於 IAuthenticationService 使用中的 。 Status401Unauthorized 和 Status403Forbidden 是可能的狀態結果。
Conflict(Object)	Status409Conflict產生回應。
Conflict<TValue>(TValue)	Status409Conflict產生回應。
Content(String, MediaTypeHeaderValue)	將 content 字串寫入 HTTP 回應。
Content(String, String, Encoding)	將 content 字串寫入 HTTP 回應。 這相當於 Text(String, String, Encoding)。
Content(String, String, Encoding, Nullable<Int32>)	將 content 字串寫入 HTTP 回應。 這相當於 Text(String, String, Encoding, Nullable<Int32>)。
Created()	Status201Created產生回應。
Created(String, Object)	Status201Created產生回應。
Created(Uri, Object)	Status201Created產生回應。
Created<TValue>(String, TValue)	Status201Created產生回應。
Created<TValue>(Uri, TValue)	Status201Created產生回應。
CreatedAtRoute(String, Object, Object)	Status201Created產生回應。
CreatedAtRoute(String, RouteValueDictionary, Object)	Status201Created產生回應。
CreatedAtRoute<TValue>(String, Object, TValue)	Status201Created產生回應。
CreatedAtRoute<TValue>(String, RouteValueDictionary, TValue)	Status201Created產生回應。
File(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue)	將位元組陣列內容寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。 此 API 是 的 Bytes(Byte[], String, String, Boolean, Nullable<DateTimeOffset>, EntityTagHeaderValue) 別名。
File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	將指定的 Stream 寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。 此 API 是 的 Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean) 別名。
File(String, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	將指定 path 位置的 檔案寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。
Forbid(AuthenticationProperties, IList<String>)	IResult建立在執行時叫用 的 ForbidAsync(HttpContext, String, AuthenticationProperties) 。 根據預設，執行此結果會 Status403Forbidden 傳回 。 某些驗證配置，例如 Cookie，會轉換成 Status403Forbidden 重新導向以顯示登入頁面。
Json(Object, JsonSerializerOptions, String, Nullable<Int32>)	建立 ， IResult 將指定的 data 物件序列化為 JSON。
Json(Object, JsonTypeInfo, String, Nullable<Int32>)	建立 ， IResult 將指定的 data 物件序列化為 JSON。
Json(Object, Type, JsonSerializerContext, String, Nullable<Int32>)	建立 ， IResult 將指定的 data 物件序列化為 JSON。
Json<TValue>(TValue, JsonSerializerContext, String, Nullable<Int32>)	建立 ， IResult 將指定的 data 物件序列化為 JSON。
Json<TValue>(TValue, JsonSerializerOptions, String, Nullable<Int32>)	建立 ， IResult 將指定的 data 物件序列化為 JSON。
Json<TValue>(TValue, JsonTypeInfo<TValue>, String, Nullable<Int32>)	建立 ， IResult 將指定的 data 物件序列化為 JSON。
LocalRedirect(String, Boolean, Boolean)	重新導向至指定的 localUrl 。 設定 和 preserveMethod 時 permanent ，設定 Status308PermanentRedirect 狀態碼。 設定時 preserveMethod ，設定 Status307TemporaryRedirect 狀態碼。 設定時 permanent ，設定 Status301MovedPermanently 狀態碼。 否則，請設定 Status302Found 。
NoContent()	Status204NoContent產生回應。
NotFound(Object)	Status404NotFound產生回應。
NotFound<TValue>(TValue)	Status404NotFound產生回應。
Ok(Object)	Status200OK產生回應。
Ok<TValue>(TValue)	Status200OK產生回應。
Problem(ProblemDetails)	ProblemDetails產生回應。
Problem(String, String, Nullable<Int32>, String, String, IDictionary<String,Object>)	ProblemDetails產生回應。
Redirect(String, Boolean, Boolean)	重新導向至指定的 url 。 設定 和 preserveMethod 時 permanent ，設定 Status308PermanentRedirect 狀態碼。 設定時 preserveMethod ，設定 Status307TemporaryRedirect 狀態碼。 設定時 permanent ，設定 Status301MovedPermanently 狀態碼。 否則，請設定 Status302Found 。
RedirectToRoute(String, Object, Boolean, Boolean, String)	重新導向至指定的路由。 設定 和 preserveMethod 時 permanent ，設定 Status308PermanentRedirect 狀態碼。 設定時 preserveMethod ，設定 Status307TemporaryRedirect 狀態碼。 設定時 permanent ，設定 Status301MovedPermanently 狀態碼。 否則，請設定 Status302Found 。
RedirectToRoute(String, RouteValueDictionary, Boolean, Boolean, String)	重新導向至指定的路由。 設定 和 preserveMethod 時 permanent ，設定 Status308PermanentRedirect 狀態碼。 設定時 preserveMethod ，設定 Status307TemporaryRedirect 狀態碼。 設定時 permanent ，設定 Status301MovedPermanently 狀態碼。 否則，請設定 Status302Found 。
SignIn(ClaimsPrincipal, AuthenticationProperties, String)	IResult建立在執行時叫用 的 SignInAsync(HttpContext, String, ClaimsPrincipal, AuthenticationProperties) 。
SignOut(AuthenticationProperties, IList<String>)	IResult建立在執行時叫用 的 SignOutAsync(HttpContext, String, AuthenticationProperties) 。
StatusCode(Int32)	IResult藉由指定 statusCode 來建立 物件。
Stream(Func<Stream,Task>, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue)	允許直接寫入回應本文。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。
Stream(PipeReader, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	將指定 PipeReader 的內容寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。
Stream(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean)	將指定的 Stream 寫入回應。 這支援範圍要求 (Status206PartialContent ，或 Status416RangeNotSatisfiable 範圍不符合) 。 此 API 是 的 File(Stream, String, String, Nullable<DateTimeOffset>, EntityTagHeaderValue, Boolean) 別名。
Text(ReadOnlySpan<Byte>, String, Nullable<Int32>)	將 utf8Content UTF-8 編碼文字寫入 HTTP 回應。
Text(String, String, Encoding)	將 content 字串寫入 HTTP 回應。 這是 的 Content(String, String, Encoding) 別名。
Text(String, String, Encoding, Nullable<Int32>)	將 content 字串寫入 HTTP 回應。 這是 的 Content(String, String, Encoding, Nullable<Int32>) 別名。
Unauthorized()	Status401Unauthorized產生回應。
UnprocessableEntity(Object)	Status422UnprocessableEntity產生回應。
UnprocessableEntity<TValue>(TValue)	Status422UnprocessableEntity產生回應。
ValidationProblem(IDictionary<String,String[]>, String, String, Nullable<Int32>, String, String, IDictionary<String,Object>)	Status400BadRequest產生具有 HttpValidationProblemDetails 值的回應。