HttpRequest 類別

定義

命名空間:

Microsoft.AspNetCore.Http

組件:

Microsoft.AspNetCore.Http.Abstractions.dll

套件:

Microsoft.AspNetCore.App.Ref v8.0.0

來源:

HttpRequest.cs

表示個別 HTTP 要求的傳入端。

public ref class HttpRequest abstract

public abstract class HttpRequest

type HttpRequest = class

Public MustInherit Class HttpRequest

繼承

Object

HttpRequest

建構函式

HttpRequest()

表示個別 HTTP 要求的傳入端。

屬性

Body	取得或設定要求本文 Stream 。
BodyReader	取得要求本文 PipeReader 。
ContentLength	取得或設定 Content-Length 標頭。
ContentType	取得或設定 Content-Type 標頭。
Cookies	取得此要求的 Cookie 集合。
Form	取得或設定要求本文做為表單。
HasFormContentType	檢查表單類型的 Content-Type 標頭。
Headers	取得要求標頭。
Host	取得或設定 Host 標頭。 可能包含連接埠。
HttpContext	HttpContext取得這個要求的 。
IsHttps	如果 RequestScheme 為 HTTPs，則會傳回 true。
Method	取得或設定 HTTP 方法。
Path	取得或設定識別所要求資源之要求路徑的部分。 如果 PathBase 包含完整路徑，或針對 'OPTIONS *' 要求，此值可能是 Empty 。 除了 '%2F' 以外，路徑會完全解碼為 '/'，並變更路徑區段的意義。 '%2F' 只能在將路徑分割成區段之後取代。
PathBase	取得或設定要求的基底路徑。 路徑基底不應以結尾斜線結尾。
Protocol	取得或設定要求通訊協定 (，例如 HTTP/1.1) 。
Query	取得從 Request.QueryString 剖析的查詢值集合。
QueryString	取得或設定用來在 Request.Query 中建立查詢集合的原始查詢字串。
RouteValues	取得這個要求的路由值集合。
Scheme	取得或設定 HTTP 要求配置。

方法

ReadFormAsync(CancellationToken)

如果是表單，則讀取要求本文。

擴充方法

GetMultipartBoundary(HttpRequest)	從 Content-Type 標頭取得多部分界限。
GetDisplayUrl(HttpRequest)	以完全未逸出的形式傳回要求 URL 的合併元件 (，但 QueryString) 僅適用于顯示。 此格式不應該用於 HTTP 標頭或其他 HTTP 作業。
GetEncodedPathAndQuery(HttpRequest)	傳回相對 URI。
GetEncodedUrl(HttpRequest)	以完全逸出形式傳回要求 URL 的合併元件，適合用於 HTTP 標頭和其他 HTTP 作業。
GetTypedHeaders(HttpRequest)	取得強型別 HTTP 要求標頭。
GetHeaderParsing(HttpRequest)	取得標頭剖析功能，以存取已剖析的標頭值。
TryGetHeaderValue<T>(HttpRequest, HeaderKey<T>, T)	如果標頭值存在且可以剖析，則嘗試取得標頭值。
TryGetHeaderValue<T>(HttpRequest, HeaderKey<T>, T, ParsingResult)	如果標頭值存在且可以剖析，則嘗試取得標頭值。
HasJsonContentType(HttpRequest)	檢查 JSON 類型的 Content-Type 標頭。
ReadFromJsonAsync(HttpRequest, JsonTypeInfo, CancellationToken)	從要求讀取 JSON，並將 還原序列化為物件類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
ReadFromJsonAsync(HttpRequest, Type, JsonSerializerOptions, CancellationToken)	從要求讀取 JSON，並將 還原序列化為指定的類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
ReadFromJsonAsync(HttpRequest, Type, JsonSerializerContext, CancellationToken)	從要求讀取 JSON，並將 還原序列化為指定的類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
ReadFromJsonAsync(HttpRequest, Type, CancellationToken)	從要求讀取 JSON，並將 還原序列化為指定的類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
ReadFromJsonAsync<TValue>(HttpRequest, JsonSerializerOptions, CancellationToken)	從要求讀取 JSON，並將 還原序列化為指定的類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
ReadFromJsonAsync<TValue>(HttpRequest, JsonTypeInfo<TValue>, CancellationToken)	從要求讀取 JSON，並將 還原序列化為指定的類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
ReadFromJsonAsync<TValue>(HttpRequest, CancellationToken)	從要求讀取 JSON，並將 還原序列化為指定的類型。 如果要求的內容類型不是已知的 JSON 類型，則會擲回錯誤。
EnableBuffering(HttpRequest)	request Body 請確定 可以多次讀取 。 通常會緩衝處理記憶體中的要求主體;會將大於 30K 位元組的要求寫入磁片。
EnableBuffering(HttpRequest, Int32)	request Body 請確定 可以多次讀取 。 通常會緩衝處理記憶體中的要求主體;會將大於 bufferThreshold 位元組的要求寫入磁片。
EnableBuffering(HttpRequest, Int32, Int64)	request Body 請確定 可以多次讀取 。 通常會緩衝處理記憶體中的要求主體;會將大於 bufferThreshold 位元組的要求寫入磁片。
EnableBuffering(HttpRequest, Int64)	request Body 請確定 可以多次讀取 。 通常會緩衝處理記憶體中的要求主體;會將大於 30K 位元組的要求寫入磁片。
ReadFormAsync(HttpRequest, FormOptions, CancellationToken)	以具有指定選項的表單形式讀取要求本文。 只有在尚未讀取表單時，才會使用這些選項。
CheckTrailersAvailable(HttpRequest)	檢查要求是否支援預告片，而且現在可供讀取。 這並不表示有任何要讀取的預告片。
GetDeclaredTrailers(HttpRequest)	取得要求 「Trailer」 標頭，其中列出在本文之後預期哪些預告片。
GetTrailer(HttpRequest, String)	從回應取得要求的尾端標頭。 Check SupportsTrailers(HttpRequest) 或 NotSupportedException 可能會擲回。 Check CheckTrailersAvailable(HttpRequest) 或 InvalidOperationException 可能會擲回。
SupportsTrailers(HttpRequest)	指出要求是否支援接收預告片標頭。