HttpWorkerRequest Klasse
Definition
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.
Diese abstrakte Klasse definiert die Basisarbeitsmethoden und -enumerationen, die von ASP.NET verwaltetem Code zum Verarbeiten von Anforderungen verwendet werden.
public ref class HttpWorkerRequest abstract
[System.Runtime.InteropServices.ComVisible(false)]
public abstract class HttpWorkerRequest
[<System.Runtime.InteropServices.ComVisible(false)>]
type HttpWorkerRequest = class
Public MustInherit Class HttpWorkerRequest
- Vererbung
-
HttpWorkerRequest
- Abgeleitet
- Attribute
Hinweise
In den meisten Fällen behandelt Ihr Code HttpWorkerRequest nicht direkt, da Anforderungs- und Antwortdaten über die Klassen HttpRequest und HttpResponse verfügbar gemacht werden. Einige interne ASP.NET Klassen erweitern diese Klasse. Wenn Ihr Code eine eigene Hostingumgebung implementiert, muss diese Klasse erweitert werden, um die ProcessRequest Methode aufzurufen. Darüber hinaus könnte Ihr Code eine abgeleitete Klasse zum Ausführen untergeordneter Anfragen in einer bestimmten Anwendung erstellen, um deren Instanz an ProcessRequest weiterzugeben. In diesem Fall sollte die abgeleitete Klasse einen Verweis auf die aktuelle Klasse HttpWorkerRequest beibehalten und die meisten Methoden an sie delegieren.
Konstruktoren
| Name | Beschreibung |
|---|---|
| HttpWorkerRequest() |
Initialisiert eine neue Instanz der HttpWorkerRequest-Klasse. |
Felder
| Name | Beschreibung |
|---|---|
| HeaderAccept |
Gibt die Indexnummer für den |
| HeaderAcceptCharset |
Gibt die Indexnummer für den |
| HeaderAcceptEncoding |
Gibt die Indexnummer für den |
| HeaderAcceptLanguage |
Gibt die Indexnummer für den |
| HeaderAcceptRanges |
Gibt die Indexnummer für den |
| HeaderAge |
Gibt die Indexnummer für den |
| HeaderAllow |
Gibt die Indexnummer für den |
| HeaderAuthorization |
Gibt die Indexnummer für den |
| HeaderCacheControl |
Der Index, der den HTTP-Header |
| HeaderConnection |
Gibt die Indexnummer für den |
| HeaderContentEncoding |
Gibt die Indexnummer für den |
| HeaderContentLanguage |
Gibt die Indexnummer für den |
| HeaderContentLength |
Gibt die Indexnummer für den |
| HeaderContentLocation |
Gibt die Indexnummer für den |
| HeaderContentMd5 |
Gibt die Indexnummer für den |
| HeaderContentRange |
Gibt die Indexnummer für den |
| HeaderContentType |
Gibt die Indexnummer für den |
| HeaderCookie |
Gibt die Indexnummer für den |
| HeaderDate |
Gibt die Indexnummer für den |
| HeaderEtag |
Gibt die Indexnummer für den |
| HeaderExpect |
Gibt die Indexnummer für den |
| HeaderExpires |
Gibt die Indexnummer für den |
| HeaderFrom |
Gibt die Indexnummer für den |
| HeaderHost |
Gibt die Indexnummer für den |
| HeaderIfMatch |
Gibt die Indexnummer für den |
| HeaderIfModifiedSince |
Gibt die Indexnummer für den |
| HeaderIfNoneMatch |
Gibt die Indexnummer für den |
| HeaderIfRange |
Gibt die Indexnummer für den |
| HeaderIfUnmodifiedSince |
Gibt die Indexnummer für den |
| HeaderKeepAlive |
Gibt die Indexnummer für den |
| HeaderLastModified |
Gibt die Indexnummer für den |
| HeaderLocation |
Gibt die Indexnummer für den |
| HeaderMaxForwards |
Gibt die Indexnummer für den |
| HeaderPragma |
Gibt die Indexnummer für den |
| HeaderProxyAuthenticate |
Gibt die Indexnummer für den |
| HeaderProxyAuthorization |
Gibt die Indexnummer für den |
| HeaderRange |
Gibt die Indexnummer für den |
| HeaderReferer |
Gibt die Indexnummer für den |
| HeaderRetryAfter |
Gibt die Indexnummer für den |
| HeaderServer |
Gibt die Indexnummer für den |
| HeaderSetCookie |
Gibt die Indexnummer für den |
| HeaderTe |
Gibt die Indexnummer für den |
| HeaderTrailer |
Gibt die Indexnummer für den |
| HeaderTransferEncoding |
Gibt die Indexnummer für den |
| HeaderUpgrade |
Gibt die Indexnummer für den |
| HeaderUserAgent |
Gibt die Indexnummer für den |
| HeaderVary |
Gibt die Indexnummer für den |
| HeaderVia |
Gibt die Indexnummer für den |
| HeaderWarning |
Gibt die Indexnummer für den |
| HeaderWwwAuthenticate |
Gibt die Indexnummer für den |
| ReasonCachePolicy |
Gibt einen Grund für die Anforderung an. |
| ReasonCacheSecurity |
Gibt einen Grund für die Anforderung an. |
| ReasonClientDisconnect |
Gibt einen Grund für die Anforderung an. |
| ReasonDefault |
Gibt einen Grund für die Anforderung an. Der Standardwert ist ReasonResponseCacheMiss. |
| ReasonFileHandleCacheMiss |
Gibt einen Grund für die Anforderung an. |
| ReasonResponseCacheMiss |
Gibt einen Grund für die Anforderung an. |
| RequestHeaderMaximum |
Gibt die Indexnummer für den |
| ResponseHeaderMaximum |
Gibt die Indexnummer für den |
Eigenschaften
| Name | Beschreibung |
|---|---|
| MachineConfigPath |
Ruft den vollständigen physischen Pfad zur Machine.config Datei ab. |
| MachineInstallDirectory |
Ruft den physischen Pfad zum Verzeichnis ab, in dem die ASP.NET Binärdateien installiert sind. |
| RequestTraceIdentifier |
Ruft die entsprechende Ereignisverfolgung für Windows Ablaufverfolgungs-ID für die aktuelle Anforderung ab. |
| RootWebConfigPath |
Ruft den vollständigen physischen Pfad zur Stammdatei Web.config Ab. |
| SupportsAsyncFlush |
Ruft einen Wert ab, der angibt, ob asynchrone Leervorgänge unterstützt werden. |
| SupportsAsyncRead |
Ruft einen Wert ab, der angibt, ob asynchrone Lesevorgänge unterstützt werden. |
Methoden
| Name | Beschreibung |
|---|---|
| BeginFlush(AsyncCallback, Object) |
Sendet die aktuell gepufferte Antwort an den Client. |
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Startet einen asynchronen Lesevorgang des Anforderungsentitätstexts. |
| CloseConnection() |
Beendet die Verbindung mit dem Client. |
| EndFlush(IAsyncResult) |
Wartet auf den ausstehenden asynchronen Leerenvorgang, bis der Vorgang abgeschlossen ist. |
| EndOfRequest() |
Wird von der Laufzeit verwendet, um die HttpWorkerRequest Anforderungsverarbeitung für die aktuelle Anforderung zu benachrichtigen, ist abgeschlossen. |
| EndRead(IAsyncResult) |
Wartet, bis der ausstehende asynchrone Lesevorgang abgeschlossen ist. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FlushResponse(Boolean) |
Sendet alle ausstehenden Antwortdaten an den Client. |
| GetAppPath() |
Gibt den virtuellen Pfad zur derzeit ausgeführten Serveranwendung zurück. |
| GetAppPathTranslated() |
Gibt den physischen Pfad zur derzeit ausgeführten Serveranwendung zurück. |
| GetAppPoolID() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Anwendungspool-ID für die aktuelle URL zurückgegeben. |
| GetBytesRead() |
Ruft die Anzahl der vom Client gelesenen Bytes ab. |
| GetClientCertificate() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden die Zertifizierungsfelder (im X.509-Standard angegeben) aus einer vom Client ausgestellten Anforderung abgerufen. |
| GetClientCertificateBinaryIssuer() |
Ruft den Zertifikataussteller im Binärformat ab. |
| GetClientCertificateEncoding() |
Wenn eine abgeleitete Klasse überschrieben wird, wird das Encoding Objekt zurückgegeben, in dem das Clientzertifikat codiert wurde. |
| GetClientCertificatePublicKey() |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, ruft ein |
| GetClientCertificateValidFrom() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft das Datum ab, an dem das Zertifikat gültig wird. Das Datum variiert mit internationalen Einstellungen. |
| GetClientCertificateValidUntil() |
Ruft das Ablaufdatum des Zertifikats ab. |
| GetConnectionID() |
Wenn eine abgeleitete Klasse überschrieben wird, wird die ID der aktuellen Verbindung zurückgegeben. |
| GetFilePath() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der virtuelle Pfad zum angeforderten URI zurückgegeben. |
| GetFilePathTranslated() |
Gibt den physischen Dateipfad an den angeforderten URI zurück (und übersetzt ihn aus dem virtuellen Pfad zum physischen Pfad: z. B. "/proj1/page.aspx" in "c:\dir\page.aspx") |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetHttpVerbName() |
Gibt das angegebene Element des Anforderungsheaders zurück. |
| GetHttpVersion() |
Bietet Zugriff auf die HTTP-Version der Anforderung (z. B. "HTTP/1.1"). |
| GetKnownRequestHeader(Int32) |
Gibt den standardmäßigen HTTP-Anforderungsheader zurück, der dem angegebenen Index entspricht. |
| GetKnownRequestHeaderIndex(String) |
Gibt die Indexnummer des angegebenen HTTP-Anforderungsheaders zurück. |
| GetKnownRequestHeaderName(Int32) |
Gibt den Namen des angegebenen HTTP-Anforderungsheaders zurück. |
| GetKnownResponseHeaderIndex(String) |
Gibt die Indexnummer des angegebenen HTTP-Antwortheaders zurück. |
| GetKnownResponseHeaderName(Int32) |
Gibt den Namen des angegebenen HTTP-Antwortheaders zurück. |
| GetLocalAddress() |
Bietet Zugriff auf das angegebene Element des Anforderungsheaders. |
| GetLocalPort() |
Bietet Zugriff auf das angegebene Element des Anforderungsheaders. |
| GetPathInfo() |
Gibt zusätzliche Pfadinformationen für eine Ressource mit einer URL-Erweiterung zurück. Das heißt, für den Pfad /virdir/page.html/tail lautet der |
| GetPreloadedEntityBody() |
Gibt den Teil des HTTP-Anforderungstexts zurück, der bereits gelesen wurde. |
| GetPreloadedEntityBody(Byte[], Int32) |
Ruft den Teil des HTTP-Anforderungstexts ab, der derzeit mithilfe der angegebenen Pufferdaten und des Byteoffsets gelesen wurde. |
| GetPreloadedEntityBodyLength() |
Ruft die Länge des Teils des HTTP-Anforderungstexts ab, der zurzeit gelesen wurde. |
| GetProtocol() |
Wenn eine abgeleitete Klasse überschrieben wird, wird das HTTP-Protokoll (HTTP oder HTTPS) zurückgegeben. |
| GetQueryString() |
Gibt die abfragezeichenfolge zurück, die in der Anforderungs-URL angegeben ist. |
| GetQueryStringRawBytes() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Antwortabfragezeichenfolge als Bytearray zurückgegeben. |
| GetRawUrl() |
Gibt den URL-Pfad zurück, der im Anforderungsheader enthalten ist, wobei die Abfragezeichenfolge angefügt ist. |
| GetRemoteAddress() |
Bietet Zugriff auf das angegebene Element des Anforderungsheaders. |
| GetRemoteName() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Name des Clientcomputers zurückgegeben. |
| GetRemotePort() |
Bietet Zugriff auf das angegebene Element des Anforderungsheaders. |
| GetRequestReason() |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, wird der Grund für die Anforderung zurückgegeben. |
| GetServerName() |
Wenn eine abgeleitete Klasse überschrieben wird, wird der Name des lokalen Servers zurückgegeben. |
| GetServerVariable(String) |
Gibt eine einzelne Servervariable aus einem Wörterbuch von Servervariablen zurück, die der Anforderung zugeordnet sind. |
| GetStatusDescription(Int32) |
Gibt eine Zeichenfolge zurück, die den Namen des angegebenen HTTP-Statuscodes beschreibt. |
| GetTotalEntityBodyLength() |
Ruft die Länge des gesamten HTTP-Anforderungstexts ab. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUnknownRequestHeader(String) |
Gibt einen nicht standardmäßigen HTTP-Anforderungsheaderwert zurück. |
| GetUnknownRequestHeaders() |
Ruft alle nicht standardmäßigen HTTP-Headernamen-Wert-Paare ab. |
| GetUriPath() |
Gibt den virtuellen Pfad zum angeforderten URI zurück. |
| GetUrlContextID() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Kontext-ID der aktuellen Verbindung zurückgegeben. |
| GetUserToken() |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, wird das Identitätswechseltoken des Clients zurückgegeben. |
| GetVirtualPathToken() |
Ruft das Identitätswechseltoken für den virtuellen Anforderungspfad ab. |
| HasEntityBody() |
Gibt einen Wert zurück, der angibt, ob die Anforderung Textkörperdaten enthält. |
| HeadersSent() |
Gibt einen Wert zurück, der angibt, ob HTTP-Antwortheader für die aktuelle Anforderung an den Client gesendet wurden. |
| IsClientConnected() |
Gibt einen Wert zurück, der angibt, ob die Clientverbindung noch aktiv ist. |
| IsEntireEntityBodyIsPreloaded() |
Gibt einen Wert zurück, der angibt, ob alle Anforderungsdaten verfügbar sind und keine weiteren Lesevorgänge vom Client erforderlich sind. |
| IsSecure() |
Gibt einen Wert zurück, der angibt, ob die Verbindung SSL verwendet. |
| MapPath(String) |
Gibt den physischen Pfad zurück, der dem angegebenen virtuellen Pfad entspricht. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ReadEntityBody(Byte[], Int32, Int32) |
Liest Anforderungsdaten vom Client (wenn nicht vorinstalliert) mithilfe des angegebenen Puffers zum Lesen aus, Byte-Offset und maximale Bytes. |
| ReadEntityBody(Byte[], Int32) |
Liest Anforderungsdaten vom Client (wenn nicht vorab geladen). |
| SendCalculatedContentLength(Int32) |
Fügt der Antwort einen |
| SendCalculatedContentLength(Int64) |
Fügt der Antwort für Nachrichtentexte, die größer als 2 GB sind, einen |
| SendKnownResponseHeader(Int32, String) |
Fügt der Antwort einen standardmäßigen HTTP-Header hinzu. |
| SendResponseFromFile(IntPtr, Int64, Int64) |
Fügt der Antwort den Inhalt der angegebenen Datei hinzu und gibt die Startposition in der Datei und die Anzahl der zu sendenden Bytes an. |
| SendResponseFromFile(String, Int64, Int64) |
Fügt der Antwort den Inhalt der angegebenen Datei hinzu und gibt die Startposition in der Datei und die Anzahl der zu sendenden Bytes an. |
| SendResponseFromMemory(Byte[], Int32) |
Fügt der Antwort die angegebene Anzahl von Bytes aus einem Bytearray hinzu. |
| SendResponseFromMemory(IntPtr, Int32) |
Fügt der Antwort die angegebene Anzahl von Bytes aus einem Speicherblock hinzu. |
| SendStatus(Int32, String) |
Gibt den HTTP-Statuscode und die Statusbeschreibung der Antwort an, z |
| SendUnknownResponseHeader(String, String) |
Fügt der Antwort einen nicht standardmäßigen HTTP-Header hinzu. |
| SetEndOfSendNotification(HttpWorkerRequest+EndOfSendNotification, Object) |
Registriert sich für eine optionale Benachrichtigung, wenn alle Antwortdaten gesendet werden. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |