HttpRequest Classe

Définition

Espace de noms:

Microsoft.AspNetCore.Http

Assembly:

Microsoft.AspNetCore.Http.Abstractions.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Représente le côté entrant d’une requête HTTP individuelle.

public ref class HttpRequest abstract

public abstract class HttpRequest

type HttpRequest = class

Public MustInherit Class HttpRequest

Héritage

Object

HttpRequest

Constructeurs

HttpRequest()

Représente le côté entrant d’une requête HTTP individuelle.

Propriétés

Body	Obtient ou définit le corps Streamde la requête .
BodyReader	Obtient le corps PipeReaderde la demande .
ContentLength	Obtient ou définit l'en-tête Content-Length.
ContentType	Obtient ou définit l'en-tête Content-Type.
Cookies	Obtient la collection de cookies pour cette demande.
Form	Obtient ou définit le corps de la demande sous forme de formulaire.
HasFormContentType	Recherche les types de formulaire dans l’en-tête Content-Type.
Headers	Obtient les en-têtes de la demande.
Host	Obtient ou définit l’en-tête hôte. Peut inclure le port.
HttpContext	Obtient le HttpContext pour cette requête.
IsHttps	Retourne true si requestScheme a la valeur https.
Method	Obtient ou définit la méthode HTTP.
Path	Obtient ou définit la partie du chemin d’accès de la requête qui identifie la ressource demandée. La valeur peut être Empty si PathBase contient le chemin d’accès complet, ou pour les requêtes « OPTIONS * ». Le chemin d’accès est entièrement décodé par le serveur, à l’exception de « %2F », qui décode en « / » et modifie la signification des segments de chemin d’accès. '%2F' ne peut être remplacé qu’après avoir fractionné le chemin en segments.
PathBase	Obtient ou définit le chemin de base de la requête. La base de chemin ne doit pas se terminer par une barre oblique de fin.
Protocol	Obtient ou définit le protocole de requête (par exemple, HTTP/1.1).
Query	Obtient la collection de valeurs de requête analysée à partir de Request.QueryString.
QueryString	Obtient ou définit la chaîne de requête brute utilisée pour créer la collection de requêtes dans Request.Query.
RouteValues	Obtient la collection de valeurs d’itinéraire pour cette requête.
Scheme	Obtient ou définit le schéma de requête HTTP.

Méthodes

ReadFormAsync(CancellationToken)

Lit le corps de la demande s’il s’agit d’un formulaire.

Méthodes d’extension

GetMultipartBoundary(HttpRequest)	Obtient la limite en plusieurs parties de l’en-tête Content-Type .
GetDisplayUrl(HttpRequest)	Retourne les composants combinés de l’URL de requête dans une forme entièrement sans échappement (à l’exception de QueryString) adaptée uniquement à l’affichage. Ce format ne doit pas être utilisé dans les en-têtes HTTP ou d’autres opérations HTTP.
GetEncodedPathAndQuery(HttpRequest)	Retourne l’URI relatif.
GetEncodedUrl(HttpRequest)	Retourne les composants combinés de l’URL de la requête dans une forme d’échappement complète pouvant être utilisée dans les en-têtes HTTP et d’autres opérations HTTP.
GetTypedHeaders(HttpRequest)	Obtient des en-têtes de requête HTTP fortement typés.
GetHeaderParsing(HttpRequest)	Obtient la fonctionnalité d’analyse d’en-tête pour accéder aux valeurs d’en-tête analysées.
TryGetHeaderValue<T>(HttpRequest, HeaderKey<T>, T)	Tente d’obtenir une valeur d’en-tête si elle existe et peut être analysée.
TryGetHeaderValue<T>(HttpRequest, HeaderKey<T>, T, ParsingResult)	Tente d’obtenir une valeur d’en-tête si elle existe et peut être analysée.
HasJsonContentType(HttpRequest)	Recherche les types JSON dans l’en-tête Content-Type.
ReadFromJsonAsync(HttpRequest, JsonTypeInfo, CancellationToken)	Lisez json à partir de la requête et désérialisez le type d’objet. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
ReadFromJsonAsync(HttpRequest, Type, JsonSerializerOptions, CancellationToken)	Lisez JSON à partir de la requête et désérialisez le type spécifié. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
ReadFromJsonAsync(HttpRequest, Type, JsonSerializerContext, CancellationToken)	Lisez JSON à partir de la requête et désérialisez le type spécifié. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
ReadFromJsonAsync(HttpRequest, Type, CancellationToken)	Lisez JSON à partir de la requête et désérialisez le type spécifié. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
ReadFromJsonAsync<TValue>(HttpRequest, JsonSerializerOptions, CancellationToken)	Lisez JSON à partir de la requête et désérialisez le type spécifié. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
ReadFromJsonAsync<TValue>(HttpRequest, JsonTypeInfo<TValue>, CancellationToken)	Lisez JSON à partir de la requête et désérialisez le type spécifié. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
ReadFromJsonAsync<TValue>(HttpRequest, CancellationToken)	Lisez JSON à partir de la requête et désérialisez le type spécifié. Si le type de contenu de la requête n’est pas un type JSON connu, une erreur est générée.
EnableBuffering(HttpRequest)	Vérifiez que peut requestBody être lu plusieurs fois. Met normalement en mémoire tampon les corps de requête ; écrit des demandes supérieures à 30 000 octets sur le disque.
EnableBuffering(HttpRequest, Int32)	Vérifiez que peut requestBody être lu plusieurs fois. Met normalement en mémoire tampon les corps de requête ; écrit des demandes supérieures bufferThreshold à des octets sur le disque.
EnableBuffering(HttpRequest, Int32, Int64)	Vérifiez que peut requestBody être lu plusieurs fois. Met normalement en mémoire tampon les corps de requête ; écrit des demandes supérieures bufferThreshold à des octets sur le disque.
EnableBuffering(HttpRequest, Int64)	Vérifiez que peut requestBody être lu plusieurs fois. Met normalement en mémoire tampon les corps de requête ; écrit des demandes supérieures à 30 000 octets sur le disque.
ReadFormAsync(HttpRequest, FormOptions, CancellationToken)	Lit le corps de la demande sous forme de formulaire avec les options spécifiées. Ces options ne seront utilisées que si le formulaire n’a pas déjà été lu.
CheckTrailersAvailable(HttpRequest)	Vérifie si la demande prend en charge les bandes-annonces et qu’elles peuvent être lues maintenant. Cela ne signifie pas qu’il y a des bandes-annonces à lire.
GetDeclaredTrailers(HttpRequest)	Obtient l’en-tête de demande « Trailer » qui répertorie les bandes-annonces à attendre après le corps.
GetTrailer(HttpRequest, String)	Obtient l’en-tête de fin demandé de la réponse. Check SupportsTrailers(HttpRequest) ou une exception NotSupportedException peut être levée. Check CheckTrailersAvailable(HttpRequest) ou une exception InvalidOperationException peut être levée.
SupportsTrailers(HttpRequest)	Indique si la demande prend en charge la réception d’en-têtes de bande-annonce.