HttpRequest Класс

Определение

Пространство имен:: Microsoft.AspNetCore.Http

Сборка:: Microsoft.AspNetCore.Http.Abstractions.dll

Пакет:: Microsoft.AspNetCore.Http.Abstractions v1.0.0

Пакет:: Microsoft.AspNetCore.Http.Abstractions v1.1.0

Пакет:: Microsoft.AspNetCore.Http.Abstractions v2.0.0

Пакет:: Microsoft.AspNetCore.Http.Abstractions v2.1.0

Пакет:: Microsoft.AspNetCore.Http.Abstractions v2.2.0

Пакет:: Microsoft.AspNetCore.App.Ref v3.0.1

Пакет:: Microsoft.AspNetCore.App.Ref v3.1.10

Пакет:: Microsoft.AspNetCore.App.Ref v5.0.0

Пакет:: Microsoft.AspNetCore.App.Ref v6.0.6

Пакет:: Microsoft.AspNetCore.App.Ref v7.0.5

Пакет:: Microsoft.AspNetCore.App.Ref v8.0.0

Пакет:: Microsoft.AspNetCore.App.Ref v9.0.0-preview.6.24328.4

Исходный код:: 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	Возвращает или задает заголовок узла. Может включать порт.
HttpContext	Возвращает для HttpContext этого запроса.
IsHttps	Возвращает значение true, если requestScheme имеет значение https.
Method	Возвращает или задает HTTP-метод.
Path	Возвращает или задает часть пути запроса, которая идентифицирует запрошенный ресурс. Значение может иметь значение Empty , если PathBase содержит полный путь, или для запросов 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 можно прочитать несколько раз. Обычно буферизует тела запросов в памяти; записывает на диск запросы размером более 30 000 байт.
EnableBuffering(HttpRequest, Int32)	Убедитесь, что `request`Body можно прочитать несколько раз. Обычно буферизует тела запросов в памяти; записывает на диск запросы, превышающие `bufferThreshold` байты.
EnableBuffering(HttpRequest, Int32, Int64)	Убедитесь, что `request`Body можно прочитать несколько раз. Обычно буферизует тела запросов в памяти; записывает на диск запросы, превышающие `bufferThreshold` байты.
EnableBuffering(HttpRequest, Int64)	Убедитесь, что `request`Body можно прочитать несколько раз. Обычно буферизует тела запросов в памяти; записывает на диск запросы размером более 30 000 байт.
ReadFormAsync(HttpRequest, FormOptions, CancellationToken)	Чтение текста запроса в виде формы с заданными параметрами. Эти параметры будут использоваться только в том случае, если форма еще не прочитана.
CheckTrailersAvailable(HttpRequest)	Проверяет, поддерживает ли запрос трейлеры и доступны ли они для чтения. Это не означает, что есть какие-либо трейлеры для чтения.
GetDeclaredTrailers(HttpRequest)	Возвращает заголовок запроса "Trailer", который перечисляет, какие трейлеры следует ожидать после текста.
GetTrailer(HttpRequest, String)	Возвращает запрошенный конечный заголовок из ответа. Может возникнуть исключение Check SupportsTrailers(HttpRequest) или NotSupportedException. Может возникнуть исключение Check CheckTrailersAvailable(HttpRequest) или исключение InvalidOperationException.
SupportsTrailers(HttpRequest)	Указывает, поддерживает ли запрос получение заголовков трейлера.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?