HttpRequest 类

定义

命名空间:

Microsoft.AspNetCore.Http

程序集:

Microsoft.AspNetCore.Http.Abstractions.dll

包:

Microsoft.AspNetCore.App.Ref v8.0.0

Source:

HttpRequest.cs

表示单个 HTTP 请求的传入端。

C#

public abstract 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 包含完整路径，则该值可以是 Empty ;对于“OPTIONS *”请求，该值可以是 。 除“%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)	检查 Content-Type 标头中的 JSON 类型。
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)	获取请求“尾部”标头，该标头列出正文后预期的尾部。
GetTrailer(HttpRequest, String)	从响应中获取请求的尾随标头。 可能会引发 Check SupportsTrailers(HttpRequest) 或 NotSupportedException。 可能会引发 Check CheckTrailersAvailable(HttpRequest) 或 InvalidOperationException。
SupportsTrailers(HttpRequest)	指示请求是否支持接收尾部标头。

适用于