IHttpRequestFeature Schnittstelle

  • Referenz

Definition

Namespace:
Microsoft.AspNetCore.Http.Features
Assembly:
Microsoft.AspNetCore.Http.Features.dll
Paket:
Microsoft.AspNetCore.Http.Features v1.0.0
Paket:
Microsoft.AspNetCore.Http.Features v1.1.0
Paket:
Microsoft.AspNetCore.Http.Features v2.0.0
Paket:
Microsoft.AspNetCore.Http.Features v2.1.0
Paket:
Microsoft.AspNetCore.Http.Features v2.2.0
Paket:
Microsoft.AspNetCore.Http.Features v3.0.3
Paket:
Microsoft.AspNetCore.Http.Features v3.1.18
Paket:
Microsoft.AspNetCore.Http.Features v5.0.9
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-rc.2.24474.3
Quelle:
IHttpRequestFeature.cs

Enthält die Details einer bestimmten Anforderung. Diese Eigenschaften sollten alle veränderbar sein. Keine dieser Eigenschaften sollte jemals auf NULL festgelegt werden.

public interface class IHttpRequestFeature
public interface IHttpRequestFeature
type IHttpRequestFeature = interface
Public Interface IHttpRequestFeature
Abgeleitet

Eigenschaften

Body

Ruft einen Stream ab, der den Anforderungstext darstellt, falls vorhanden, oder legt dieses fest.

Null kann verwendet werden, um einen leeren Anforderungstext darzustellen.

Headers

Ruft Kopfzeilen ab, die in der Anforderung enthalten sind, aggregiert durch den Headernamen.

Die Werte werden nicht über Kopfzeilen aufgeteilt oder zusammengeführt. Z. B. die folgenden Header:

  • HeaderA: value1, value2
  • HeaderA: value3
Result in Headers["HeaderA"] = { "value1, value2", "value3" }
Method

Ruft die Anforderungsmethode ab, wie in RFC 7230 definiert, oder legt sie fest. Z.B. "GET", "HEAD", "POST" usw..
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 ersten Teil des Anforderungspfads ab, der dem Anwendungsstamm zugeordnet ist, oder legt diesen fest.

Der Wert ist nicht mit escaped versehen. Der Wert kann sein Empty.

Protocol

Ruft die HTTP-Version ab, die in RFC 7230 definiert ist, oder legt sie fest. Z.B. "HTTP/1.1"
QueryString

Ruft den Abfrageteil des Anforderungsziels ab, wie in RFC 7230 definiert, oder legt diesen fest. Der Wert kann sein Empty. Wenn nicht leer, wird das führende "?" eingeschlossen. Der Wert befindet sich in seiner ursprünglichen Form, ohne sich zu entweichen.
RawTarget

Ruft das Anforderungsziel ab, wie es in der HTTP-Anforderung gesendet wurde, oder legt es fest.

Diese Eigenschaft enthält den rohen Pfad und die vollständige Abfrage sowie andere Anforderungsziele wie * für OPTIONS-Anforderungen (https://tools.ietf.org/html/rfc7230#section-5.3).

Scheme

Ruft das Anforderungs-URI-Schema ab oder legt es fest. Z.B. "http" oder "https".

Beachten Sie, dass dieser Wert nicht in der ursprünglichen Anforderung enthalten ist. Er wird abgeleitet, indem überprüft wird, ob der Transport eine TLS-Verbindung verwendet hat oder nicht.

Gilt für: