HttpRequestBase 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.
Dient als Basisklasse für Klassen, mit denen ASP.NET die HTTP-Werte lesen können, die von einem Client während einer Webanforderung gesendet werden.
public ref class HttpRequestBase abstract
public abstract class HttpRequestBase
type HttpRequestBase = class
Public MustInherit Class HttpRequestBase
- Vererbung
-
HttpRequestBase
- Abgeleitet
Hinweise
Die HttpRequestBase Klasse ist eine abstrakte Klasse, die dieselben Member wie die HttpRequest Klasse enthält. Mit der HttpRequestBase-Klasse können Sie abgeleitete Klassen erstellen, die der HttpRequest-Klasse ähneln, aber sie können anpassen und außerhalb der ASP.NET Pipeline funktionieren. Wenn Sie Komponententests durchführen, verwenden Sie in der Regel eine abgeleitete Klasse, um Member zu implementieren, die ein angepasstes Verhalten aufweisen, das das szenario erfüllt, das Sie testen.
Die HttpRequestWrapper Klasse wird von der HttpRequestBase Klasse abgeleitet. Die HttpRequestWrapper Klasse dient als Wrapper für die HttpRequest Klasse. Zur Laufzeit verwenden Sie in der Regel eine Instanz der HttpRequestWrapper Klasse, um Elemente des HttpRequest Objekts aufzurufen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| HttpRequestBase() |
Initialisiert die Klasse für die Verwendung durch eine geerbte Klasseninstanz. Dieser Konstruktor kann nur von einer geerbten Klasse aufgerufen werden. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AcceptTypes |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, ruft ein Array von clientgestützten MIME-Akzeptiert-Typen ab. |
| AnonymousID |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der anonyme Bezeichner für den Benutzer abgerufen, sofern er verfügbar ist. |
| ApplicationPath |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der virtuelle Stammpfad der ASP.NET Anwendung auf dem Server abgerufen. |
| AppRelativeCurrentExecutionFilePath |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft den virtuellen Pfad des Anwendungsstamms ab und macht ihn relativ, indem die Tildenotation (~) für den Anwendungsstamm verwendet wird (wie in "~/page.aspx"). |
| Browser |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt werden, erhalten Sie Informationen über die Browserfunktionen des anfordernden Clients. |
| ClientCertificate |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, ruft das Clientsicherheitszertifikat der aktuellen Anforderung ab. |
| ContentEncoding |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft den Zeichensatz der vom Client bereitgestellten Daten ab oder legt diesen fest. |
| ContentLength |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, wird die Vom Client gesendete Inhalt in Bytes in Bytes ab. |
| ContentType |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft den MIME-Inhaltstyp der Anforderung ab oder legt sie fest. |
| Cookies |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, ruft die Sammlung von Cookies ab, die vom Client gesendet wurden. |
| CurrentExecutionFilePath |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der virtuelle Pfad der aktuellen Anforderung ab. |
| CurrentExecutionFilePathExtension |
Wenn sie in einer abgeleiteten Klasse implementiert wird, ruft die Erweiterung des Dateinamens ab, der in der CurrentExecutionFilePath Eigenschaft angegeben ist. |
| FilePath |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der virtuelle Pfad der aktuellen Anforderung ab. |
| Files |
Beim Überschreiben in einer abgeleiteten Klasse ruft die Sammlung von Dateien ab, die vom Client hochgeladen wurden, im mehrteiligen MIME-Format. |
| Filter |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft den Filter ab oder legt diesen fest, der verwendet werden soll, wenn der aktuelle Eingabedatenstrom gelesen wird. |
| Form |
Beim Überschreiben in einer abgeleiteten Klasse ruft die Sammlung von Formularvariablen ab, die vom Client gesendet wurden. |
| Headers |
Beim Überschreiben in einer abgeleiteten Klasse ruft die Sammlung von HTTP-Headern ab, die vom Client gesendet wurden. |
| HttpChannelBinding |
Beim Überschreiben in einer abgeleiteten Klasse ruft das ChannelBinding Objekt der aktuellen HttpWorkerRequest Instanz ab. |
| HttpMethod |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, ruft die HTTP-Datenübertragungsmethode (z |
| InputStream |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Inhalt des eingehenden HTTP-Entitätstexts abgerufen. |
| IsAuthenticated |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die Anforderung authentifiziert wurde. |
| IsLocal |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob die Anforderung vom lokalen Computer stammt. |
| IsSecureConnection |
Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob die HTTP-Verbindung sichere Sockets (HTTPS-Protokoll) verwendet. |
| Item[String] |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird das angegebene Objekt aus den Cookies, Form, oder QueryStringServerVariables Auflistungen abgerufen. |
| LogonUserIdentity |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft den WindowsIdentity Typ für den aktuellen Benutzer ab. |
| Params |
Wenn eine abgeleitete Klasse überschrieben wird, wird eine kombinierte Auflistung von QueryString, , Form, ServerVariablesund Cookies Elementen. |
| Path |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der virtuelle Pfad der aktuellen Anforderung ab. |
| PathInfo |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden zusätzliche Pfadinformationen für eine Ressource mit einer URL-Erweiterung angezeigt. |
| PhysicalApplicationPath |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der physische Dateisystempfad des Stammverzeichnisses der aktuellen Anwendung ab. |
| PhysicalPath |
Wenn eine abgeleitete Klasse überschrieben wird, wird der physische Dateisystempfad der angeforderten Ressource abgerufen. |
| QueryString |
Wenn eine abgeleitete Klasse überschrieben wird, ruft die Auflistung von HTTP-Abfragezeichenfolgenvariablen ab. |
| RawUrl |
Beim Überschreiben in einer abgeleiteten Klasse ruft die vollständige URL der aktuellen Anforderung ab. |
| ReadEntityBodyMode |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein Wert abgerufen, der angibt, ob der Anforderungsentitätstext gelesen wurde, und wenn ja, wie er gelesen wurde. |
| RequestContext |
Beim Überschreiben in einer abgeleiteten Klasse ruft die RequestContext Instanz der aktuellen Anforderung ab. |
| RequestType |
Ruft beim Überschreiben in einer abgeleiteten Klasse die HTTP-Datenübertragungsmethode ( |
| ServerVariables |
Beim Überschreiben in einer abgeleiteten Klasse ruft eine Auflistung von Webservervariablen ab. |
| TimedOutToken |
Wenn sie in einer abgeleiteten Klasse implementiert wird, ruft ein CancellationToken Objekt ab, das übersprungen wird, wenn eine Anforderung ausgeht. |
| TlsTokenBindingInfo |
Ruft die Tokenbindungsinformationen für diese Instanz ab oder legt diese fest. |
| TotalBytes |
Wenn eine abgeleitete Klasse überschrieben wird, wird die Anzahl der Bytes im aktuellen Eingabedatenstrom abgerufen. |
| Unvalidated |
Wenn sie in einer abgeleiteten Klasse implementiert wird, bietet sie Zugriff auf HTTP-Anforderungswerte, ohne die Anforderungsüberprüfung auszulösen. |
| Url |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden Informationen über die URL der aktuellen Anforderung angezeigt. |
| UrlReferrer |
Wenn eine abgeleitete Klasse überschrieben wird, werden Informationen über die URL der Clientanforderung, die mit der aktuellen URL verknüpft ist, angezeigt. |
| UserAgent |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, ruft die vollständige Benutzer-Agent-Zeichenfolge des Clients ab. |
| UserHostAddress |
Wenn eine abgeleitete Klasse überschrieben wird, ruft die IP-Hostadresse des Clients ab. |
| UserHostName |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der DNS-Name des Clients ab. |
| UserLanguages |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein sortiertes Array von Clientspracheneinstellungen abgerufen. |
Methoden
| Name | Beschreibung |
|---|---|
| Abort() |
Beendet die zugrunde liegende TCP-Verbindung, was dazu führt, dass keine ausstehende E/A fehlschlägt. |
| BinaryRead(Int32) |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein binäres Lesen einer angegebenen Anzahl von Bytes aus dem aktuellen Eingabedatenstrom ausgeführt. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBufferedInputStream() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, ruft ein Stream Objekt ab, das zum Lesen des eingehenden HTTP-Entitätstexts verwendet werden kann. |
| GetBufferlessInputStream() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, ruft ein Stream Objekt ab, das zum Lesen des eingehenden HTTP-Entitätstexts verwendet werden kann, und deaktiviert optional die anforderungslängenbeschränkung, die in der MaxRequestLength Eigenschaft festgelegt ist. |
| GetBufferlessInputStream(Boolean) |
Wenn sie in einer abgeleiteten Klasse implementiert wird, ruft ein Stream Objekt ab, das zum Lesen des eingehenden HTTP-Entitätstexts verwendet werden kann, und deaktiviert optional die anforderungslängenbeschränkung, die in der MaxRequestLength Eigenschaft festgelegt ist. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InsertEntityBody() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird eine Kopie des HTTP-Anforderungsentitätstexts in IIS bereitgestellt. |
| InsertEntityBody(Byte[], Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse implementiert wird, stellt IIS eine Kopie des HTTP-Anforderungsentitätstexts und Informationen zum Anforderungsentitätsobjekt bereit. |
| MapImageCoordinates(String) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein eingehender Bildfeld-Formularparameter den entsprechenden X-Koordinaten- und Y-Koordinatenwerten zugeordnet. |
| MapPath(String, String, Boolean) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der angegebene virtuelle Pfad einem physischen Pfad auf dem Server zugeordnet. |
| MapPath(String) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der angegebene virtuelle Pfad einem physischen Pfad auf dem Server zugeordnet. |
| MapRawImageCoordinates(String) |
Ordnet einen Formularparameter für eingehende Bildfelder den entsprechenden x- und y-Koordinatenwerten zu. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SaveAs(String, Boolean) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine HTTP-Anforderung auf dem Datenträger gespeichert. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| ValidateInput() |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, tritt die Überprüfung für die Auflistungen auf, auf die über die Cookies, Formund QueryString Eigenschaften zugegriffen wird. |