HttpRequest Klasse

Referenz

Definition

Namespace:: Microsoft.AspNetCore.Http

Assembly:: Microsoft.AspNetCore.Http.Abstractions.dll

Paket:: Microsoft.AspNetCore.Http.Abstractions v1.0.0

Paket:: Microsoft.AspNetCore.Http.Abstractions v1.1.0

Paket:: Microsoft.AspNetCore.Http.Abstractions v2.0.0

Paket:: Microsoft.AspNetCore.Http.Abstractions v2.1.0

Paket:: Microsoft.AspNetCore.Http.Abstractions v2.2.0

Paket:: Microsoft.AspNetCore.App.Ref v3.0.1

Paket:: Microsoft.AspNetCore.App.Ref v3.1.10

Paket:: Microsoft.AspNetCore.App.Ref v5.0.0

Paket:: Microsoft.AspNetCore.App.Ref v6.0.6

Paket:: Microsoft.AspNetCore.App.Ref v7.0.5

Paket:: Microsoft.AspNetCore.App.Ref v8.0.0

Paket:: Microsoft.AspNetCore.App.Ref v9.0.0-preview.6.24328.4

Quelle:: HttpRequest.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt die eingehende Seite einer einzelnen HTTP-Anforderung dar.

public ref class HttpRequest abstract

public abstract class HttpRequest

type HttpRequest = class

Public MustInherit Class HttpRequest

Vererbung: Object
HttpRequest

Konstruktoren

HttpRequest()

Stellt die eingehende Seite einer einzelnen HTTP-Anforderung dar.

Eigenschaften

Body	Ruft den Anforderungstext Streamab oder legt diese fest.
BodyReader	Ruft den Anforderungstext ab PipeReader.
ContentLength	Ruft den Content-Length-Header ab oder legt diesen fest.
ContentType	Ruft den Content-Type-Header ab oder legt diesen fest.
Cookies	Ruft die Auflistung der Cookies für diese Anforderung ab.
Form	Ruft den Anforderungstext als Formular ab oder legt dieses fest.
HasFormContentType	Überprüft den Content-Type-Header auf Formulartypen.
Headers	Ruft die Anforderungsheader ab.
Host	Ruft den Hostheader ab oder legt diese fest. Kann ggf. den Port umfassen.
HttpContext	Ruft die HttpContext für diese Anforderung ab.
IsHttps	Gibt true zurück, wenn requestScheme https ist.
Method	Ruft die HTTP-Methode ab oder legt diese fest.
Path	Ruft den Teil des Anforderungspfads ab, der die angeforderte Ressource identifiziert, oder legt diesen fest. Der Wert kann sein, wenn PathBase der vollständige Pfad oder für "OPTIONS *"-Anforderungen enthalten istEmpty. Der Pfad wird vom Server vollständig decodiert, mit Ausnahme von "%2F", was zu "/" decodiert und die Bedeutung der Pfadsegmente ändert. "%2F" kann nur ersetzt werden, nachdem der Pfad in Segmente aufgeteilt wurde.
PathBase	Ruft den Basispfad für die Anforderung ab oder legt diese fest. Die Pfadbasis sollte nicht mit einem nachfolgenden Schrägstrich enden.
Protocol	Ruft das Anforderungsprotokoll ab (z. B. HTTP/1.1).
Query	Ruft die Abfragewertauflistung ab, die von Request.QueryString analysiert wird.
QueryString	Ruft die unformatierte Abfragezeichenfolge ab, die zum Erstellen der Abfrageauflistung in Request.Query verwendet wird, oder legt diese fest.
RouteValues	Ruft die Auflistung der Routenwerte für diese Anforderung ab.
Scheme	Ruft das HTTP-Anforderungsschema ab oder legt es fest.

Methoden

ReadFormAsync(CancellationToken)

Liest den Anforderungstext, wenn es sich um ein Formular handelt.

Erweiterungsmethoden

GetMultipartBoundary(HttpRequest)	Ruft die mehrteilige Grenze aus dem `Content-Type` Header ab.
GetDisplayUrl(HttpRequest)	Gibt die kombinierten Komponenten der Anforderungs-URL in einer vollständig nicht mit Escape versehenen Form zurück (mit Ausnahme des QueryString), die nur für die Anzeige geeignet ist. Dieses Format sollte nicht in HTTP-Headern oder anderen HTTP-Vorgängen verwendet werden.
GetEncodedPathAndQuery(HttpRequest)	Gibt den relativen URI zurück.
GetEncodedUrl(HttpRequest)	Gibt die kombinierten Komponenten der Anforderungs-URL in einer vollständig mit Escape versehenen Form zurück, die für die Verwendung in HTTP-Headern und anderen HTTP-Vorgängen geeignet ist.
GetTypedHeaders(HttpRequest)	Ruft stark typisierte HTTP-Anforderungsheader ab.
GetHeaderParsing(HttpRequest)	Ruft die Headeranalysefunktion ab, um auf analysierte Headerwerte zuzugreifen.
TryGetHeaderValue<T>(HttpRequest, HeaderKey<T>, T)	Versucht, einen Headerwert abzurufen, wenn er vorhanden ist und analysiert werden kann.
TryGetHeaderValue<T>(HttpRequest, HeaderKey<T>, T, ParsingResult)	Versucht, einen Headerwert abzurufen, wenn er vorhanden ist und analysiert werden kann.
HasJsonContentType(HttpRequest)	Überprüft den Content-Type-Header auf JSON-Typen.
ReadFromJsonAsync(HttpRequest, JsonTypeInfo, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den Objekttyp. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
ReadFromJsonAsync(HttpRequest, Type, JsonSerializerOptions, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den angegebenen Typ. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
ReadFromJsonAsync(HttpRequest, Type, JsonSerializerContext, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den angegebenen Typ. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
ReadFromJsonAsync(HttpRequest, Type, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den angegebenen Typ. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
ReadFromJsonAsync<TValue>(HttpRequest, JsonSerializerOptions, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den angegebenen Typ. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
ReadFromJsonAsync<TValue>(HttpRequest, JsonTypeInfo<TValue>, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den angegebenen Typ. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
ReadFromJsonAsync<TValue>(HttpRequest, CancellationToken)	Lesen Sie JSON aus der Anforderung, und deserialisieren Sie den angegebenen Typ. Wenn der Inhaltstyp der Anforderung kein bekannter JSON-Typ ist, wird ein Fehler ausgelöst.
EnableBuffering(HttpRequest)	Stellen Sie sicher, dass der `request`Body mehrmals gelesen werden kann. In der Regel puffert Anforderungstexte im Arbeitsspeicher; schreibt Anforderungen, die größer als 30.000 Bytes sind, auf den Datenträger.
EnableBuffering(HttpRequest, Int32)	Stellen Sie sicher, dass der `request`Body mehrmals gelesen werden kann. In der Regel puffert Anforderungstexte im Arbeitsspeicher; schreibt Anforderungen, die größer als `bufferThreshold` Bytes sind, auf den Datenträger.
EnableBuffering(HttpRequest, Int32, Int64)	Stellen Sie sicher, dass der `request`Body mehrmals gelesen werden kann. In der Regel puffert Anforderungstexte im Arbeitsspeicher; schreibt Anforderungen, die größer als `bufferThreshold` Bytes sind, auf den Datenträger.
EnableBuffering(HttpRequest, Int64)	Stellen Sie sicher, dass der `request`Body mehrmals gelesen werden kann. In der Regel puffert Anforderungstexte im Arbeitsspeicher; schreibt Anforderungen, die größer als 30.000 Bytes sind, auf den Datenträger.
ReadFormAsync(HttpRequest, FormOptions, CancellationToken)	Lesen Sie den Anforderungstext als Formular mit den angegebenen Optionen. Diese Optionen werden nur verwendet, wenn das Formular noch nicht gelesen wurde.
CheckTrailersAvailable(HttpRequest)	Überprüft, ob die Anforderung Trailer unterstützt, und sie können jetzt gelesen werden. Dies bedeutet nicht, dass es irgendwelche Trailer zu lesen gibt.
GetDeclaredTrailers(HttpRequest)	Ruft den Anforderungsheader "Trailer" ab, der auflistet, welche Trailer nach dem Textkörper zu erwarten sind.
GetTrailer(HttpRequest, String)	Ruft den angeforderten nachgestellten Header aus der Antwort ab. Überprüfen, SupportsTrailers(HttpRequest) oder es kann eine NotSupportedException ausgelöst werden. Überprüfen Oder CheckTrailersAvailable(HttpRequest) eine InvalidOperationException kann ausgelöst werden.
SupportsTrailers(HttpRequest)	Gibt an, ob die Anforderung den Empfang von Trailerheadern unterstützt.

Gilt für:

Freigeben über