Freigeben über


HttpWebResponse-Klasse

Stellt eine HTTP-spezifische Implementierung der WebResponse-Klasse bereit.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public Class HttpWebResponse
    Inherits WebResponse
    Implements ISerializable
'Usage
Dim instance As HttpWebResponse
[SerializableAttribute] 
public class HttpWebResponse : WebResponse, ISerializable
[SerializableAttribute] 
public ref class HttpWebResponse : public WebResponse, ISerializable
/** @attribute SerializableAttribute() */ 
public class HttpWebResponse extends WebResponse implements ISerializable
SerializableAttribute 
public class HttpWebResponse extends WebResponse implements ISerializable

Hinweise

Diese Klasse enthält Unterstützung für die HTTP-spezifische Verwendung von Eigenschaften und Methoden der WebResponse-Klasse. Die HttpWebResponse-Klasse wird zum Erstellen von eigenständigen HTTP-Clientanwendungen verwendet, die HTTP-Anforderungen senden und HTTP-Antworten empfangen.

Hinweis

Verwechseln Sie HttpWebResponse nicht mit der HttpResponse-Klasse, die in ASP.NET-Anwendungen verwendet wird und deren Methoden und Eigenschaften durch das systeminterne ASP.NET-Response-Objekt verfügbar gemacht werden.

Sie sollten Instanzen der HttpWebResponse-Klasse nie direkt erstellen. Verwenden Sie stattdessen die Instanz, die durch einen Aufruf von HttpWebRequest.GetResponse zurückgegeben wird. Sie müssen entweder die Stream.Close-Methode oder die HttpWebResponse.Close-Methode aufrufen, um die Antwort zu schließen und die Verbindung für die erneute Verwendung freizugeben. Es ist nicht erforderlich, sowohl die Stream.Close-Methode als auch die HttpWebResponse.Close-Methode aufzurufen. Es tritt aber auch kein Fehler auf, wenn Sie beide Methoden aufrufen.

Allgemeine Headerinformationen, die von der Internetressource zurückgegeben werden, werden als Eigenschaften der Klasse verfügbar gemacht. In der folgenden Tabelle finden Sie eine vollständige Liste. Andere Header können aus der Headers-Eigenschaft als Name-Wert-Paar gelesen werden.

Die folgende Tabelle enthält häufig verwendete 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 Stream zurückgegeben, indem die GetResponseStream-Methode aufgerufen wird.

Beispiel

Im folgenden Beispiel wird eine HttpWebResponse von einem HttpWebRequest zurückgegeben.

Dim HttpWReq As HttpWebRequest = _
   CType(WebRequest.Create("https://www.contoso.com"), HttpWebRequest)
       
Dim HttpWResp As HttpWebResponse = _
   CType(HttpWReq.GetResponse(), HttpWebResponse)
' Insert code that uses the response object.
HttpWResp.Close()
HttpWebRequest HttpWReq = 
(HttpWebRequest)WebRequest.Create("https://www.contoso.com");

HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object.
HttpWResp.Close();
HttpWebRequest^ HttpWReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "https://www.contoso.com" ));
HttpWebResponse^ HttpWResp = dynamic_cast<HttpWebResponse^>(HttpWReq->GetResponse());

// Insert code that uses the response object.
HttpWResp->Close();
HttpWebRequest httpWReq =
    ((HttpWebRequest)(WebRequest.Create("https://www.contoso.com")));
HttpWebResponse httpWResp = ((HttpWebResponse)(httpWReq.GetResponse()));
// Insert code that uses the response object.
httpWResp.Close();
var httpWReq : HttpWebRequest = HttpWebRequest(WebRequest.Create("https://www.contoso.com"))
       
var httpWResp : HttpWebResponse = HttpWebResponse(httpWReq.GetResponse())
// Insert code to use response object.
httpWResp.Close()

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.Net.WebResponse
      System.Net.HttpWebResponse

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

HttpWebResponse-Member
System.Net-Namespace
WebResponse