HttpWebResponse 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.
Stellt eine HTTP-spezifische Implementierung der WebResponse-Klasse bereit.
public ref class HttpWebResponse : System::Net::WebResponse
public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable
public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
public class HttpWebResponse : System.Net.WebResponse
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
inherit WebResponse
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
interface IDisposable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
- Vererbung
- Vererbung
- Attribute
- Implementiert
Beispiele
Im folgenden Beispiel wird ein HttpWebResponse von zurückgegeben HttpWebRequest.
HttpWebRequest^ HttpWReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com" ));
HttpWebResponse^ HttpWResp = dynamic_cast<HttpWebResponse^>(HttpWReq->GetResponse());
// Insert code that uses the response object.
HttpWResp->Close();
HttpWebRequest HttpWReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object.
HttpWResp.Close();
Dim HttpWReq As HttpWebRequest = _
CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
Dim HttpWResp As HttpWebResponse = _
CType(HttpWReq.GetResponse(), HttpWebResponse)
' Insert code that uses the response object.
HttpWResp.Close()
Hinweise
Diese Klasse enthält Unterstützung für HTTP-spezifische Verwendungen der Eigenschaften und Methoden der WebResponse -Klasse. Die HttpWebResponse -Klasse wird verwendet, um eigenständige HTTP-Clientanwendungen zu erstellen, die HTTP-Anforderungen senden und HTTP-Antworten empfangen.
Hinweis
Verwechseln HttpWebResponse Sie nicht mit der Klasse, die HttpResponse in ASP.NET Anwendungen verwendet wird und deren Methoden und Eigenschaften über ASP verfügbar gemacht werden. NET-systeminternes Response
Objekt.
Sie sollten niemals direkt eine Instanz der HttpWebResponse -Klasse erstellen. Verwenden Sie stattdessen die Instanz, die von einem Aufruf von HttpWebRequest.GetResponsezurückgegeben wird. Sie müssen entweder die Stream.Close -Methode oder HttpWebResponse.Close aufrufen, um die Antwort zu schließen und die Verbindung zur Wiederverwendung freizugeben. Es ist nicht erforderlich, beide Stream.Close und HttpWebResponse.Closeaufzurufen, aber dadurch wird kein Fehler verursacht.
Allgemeine Headerinformationen, die von der Internetressource zurückgegeben werden, werden als Eigenschaften der -Klasse verfügbar gemacht. Eine vollständige Liste finden Sie in der folgenden Tabelle. Andere Header können aus der Headers Eigenschaft als Name-Wert-Paare gelesen werden.
Die folgende Tabelle zeigt die allgemeinen HTTP-Header, die über Eigenschaften der HttpWebResponse -Klasse verfügbar sind.
Header | Eigenschaft |
---|---|
Content-Encoding | ContentEncoding |
Content-Length | ContentLength |
Content-Type | ContentType |
Last-Modified | LastModified |
Server | Server |
Der Inhalt der Antwort von der Internetressource wird als ein Stream zurückgegeben, indem die GetResponseStream -Methode aufgerufen wird.
Konstruktoren
HttpWebResponse() |
Veraltet.
Veraltet.
Veraltet.
Veraltet.
Initialisiert eine neue Instanz der HttpWebResponse-Klasse. |
HttpWebResponse(SerializationInfo, StreamingContext) |
Veraltet.
Veraltet.
Veraltet.
Initialisiert eine neue Instanz der HttpWebResponse-Klasse aus der angegebenen SerializationInfo-Instanz und der StreamingContext-Instanz. |
Eigenschaften
CharacterSet |
Ruft den Zeichensatz der Antwort ab. |
ContentEncoding |
Ruft die Methode ab, die zum Codieren des Antworttexts verwendet wird. |
ContentLength |
Ruft die Länge des von der Anforderung zurückgegebenen Inhalts ab. |
ContentType |
Ruft den Inhaltstyp der Antwort ab. |
Cookies |
Ruft die dieser Antwort zugeordneten Cookies ab oder legt diese fest. |
Headers |
Ruft die Header ab, die dieser Antwort vom Server zugeordnet sind. |
IsFromCache |
Ruft einen Boolean-Wert ab, der angibt, ob diese Antwort aus dem Cache abgerufen wurde. (Geerbt von WebResponse) |
IsMutuallyAuthenticated |
Ruft einen Boolean-Wert ab, der angibt, ob sowohl Client als auch Server authentifiziert wurden. |
IsMutuallyAuthenticated |
Ruft einen Boolean-Wert ab, der angibt, ob eine gegenseitige Authentifizierung erfolgt ist. (Geerbt von WebResponse) |
LastModified |
Ruft das Datum und die Uhrzeit der letzten Änderung des Inhalts der Antwort ab. |
Method |
Ruft die zum Zurückgeben der Antwort verwendete Methode ab. |
ProtocolVersion |
Ruft die in der Antwort verwendete Version des HTTP-Protokolls ab. |
ResponseUri |
Ruft den URI der Internetressource ab, die die Anforderung beantwortet hat. |
Server |
Ruft den Namen des Servers ab, der die Antwort gesendet hat. |
StatusCode |
Ruft den Status der Antwort ab. |
StatusDescription |
Ruft die mit der Antwort zurückgegebene Statusbeschreibung ab. |
SupportsHeaders |
Ruft einen Wert ab, der angibt, ob Header unterstützt werden. |
SupportsHeaders |
Ruft einen Wert ab, der angibt, ob Header unterstützt werden. (Geerbt von WebResponse) |
Methoden
Close() |
Schließt den Antwortstream. |
Close() |
Schließt beim Überschreiben durch eine Nachfolgerklasse den Antwortstream. (Geerbt von WebResponse) |
CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
Dispose() |
Gibt die vom WebResponse-Objekt verwendeten nicht verwalteten Ressourcen frei. (Geerbt von WebResponse) |
Dispose(Boolean) |
Gibt die vom HttpWebResponse verwendeten, nicht verwalteten Ressourcen frei und verwirft optional auch die verwalteten Ressourcen. |
Dispose(Boolean) |
Gibt die vom WebResponse-Objekt verwendeten nicht verwalteten Ressourcen und verwirft optional auch die verwalteten Ressourcen. (Geerbt von WebResponse) |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Gibt einen Hashwert für eine HttpWebResponse-Instanz zurück. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
GetObjectData(SerializationInfo, StreamingContext) |
Veraltet.
Veraltet.
Veraltet.
Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. |
GetObjectData(SerializationInfo, StreamingContext) |
Veraltet.
Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. (Geerbt von WebResponse) |
GetResponseHeader(String) |
Ruft den Inhalt eines Headers ab, der mit der Antwort zurückgegeben wurde. |
GetResponseStream() |
Ruft den Stream ab, der zum Lesen des Textkörpers der Serverantwort verwendet wird. |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
IDisposable.Dispose() |
Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Gibt alle vom HttpWebResponse verwendeten Ressourcen frei. |
IDisposable.Dispose() |
Gibt beim Überschreiben in einer abgeleiteten Klasse alle von der WebResponse verwendeten Ressourcen frei. (Geerbt von WebResponse) |
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Veraltet.
Veraltet.
Veraltet.
Serialisiert diese Instanz in das angegebene SerializationInfo-Objekt. |