HttpWebResponse HttpWebResponse HttpWebResponse HttpWebResponse Class

Definition

Stellt eine HTTP-spezifische Implementierung der WebResponse-Klasse bereit. Provides an HTTP-specific implementation of the WebResponse class.

public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
[Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
    interface IDisposable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
Vererbung
Attribute
SerializableAttribute
Implementiert

Beispiele

Das folgende Beispiel gibt eine HttpWebResponse aus einem HttpWebRequest.The following example returns an HttpWebResponse from an 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 Eigenschaften und Methoden verwendet die WebResponse Klasse.This class contains support for HTTP-specific uses of the properties and methods of the WebResponse class. Die HttpWebResponse Klasse wird verwendet, um eigenständige HTTP-Clientanwendungen zu erstellen, die HTTP-Anforderungen senden und Empfangen von HTTP-Antworten.The HttpWebResponse class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.

Hinweis

Verwechseln Sie nicht HttpWebResponse mit der HttpResponse -Klasse, die in ASP.NET-Anwendungen verwendet wird und deren Methoden und Eigenschaften werden über ASP verfügbar gemacht werden. NET des systeminternen Response Objekt.Do not confuse HttpWebResponse with the HttpResponse class that is used in ASP.NET applications and whose methods and properties are exposed through ASP.NET's intrinsic Response object.

Sie sollten niemals direkt erstellen Sie eine Instanz von der HttpWebResponse Klasse.You should never directly create an instance of the HttpWebResponse class. Verwenden Sie stattdessen die durch einen Aufruf zurückgegebene Instanz HttpWebRequest.GetResponse.Instead, use the instance returned by a call to HttpWebRequest.GetResponse. Sie müssen entweder Aufrufen der Stream.Close oder HttpWebResponse.Close Methode, um die Antwort zu schließen und die Verbindung für die Wiederverwendung freizugeben.You must call either the Stream.Close or the HttpWebResponse.Close method to close the response and release the connection for reuse. Es ist nicht notwendig, beide Stream.Close und HttpWebResponse.Close, aber dies ist also kein Fehler ausgelöst.It is not necessary to call both Stream.Close and HttpWebResponse.Close, but doing so does not cause an error.

Gemeinsame, von der Internetressource zurückgegebenen Headerinformationen wird als Eigenschaften der Klasse verfügbar gemacht.Common header information returned from the Internet resource is exposed as properties of the class. Finden Sie die folgende Tabelle enthält eine vollständige Liste.See the following table for a complete list. Andere Header gelesen werden können, aus der Headers Eigenschaft als Name/Wert-Paaren.Other headers can be read from the Headers property as name/value pairs.

Die folgende Tabelle zeigt die allgemeine HTTP-Header, die über Eigenschaften zur Verfügung stehen die HttpWebResponse Klasse.The following table shows the common HTTP headers that are available through properties of the HttpWebResponse class.

HeaderHeader EigenschaftProperty
Content-EncodingContent-Encoding ContentEncoding
Content-LengthContent-Length ContentLength
InhaltstypContent-Type ContentType
Zuletzt geändertLast-Modified LastModified
ServerServer Server

Der Inhalt der Antwort der Internetressource wird zurückgegeben, als eine Stream durch Aufrufen der GetResponseStream Methode.The contents of the response from the Internet resource are returned as a Stream by calling the GetResponseStream method.

Konstruktoren

HttpWebResponse() HttpWebResponse() HttpWebResponse() HttpWebResponse()

Initialisiert eine neue Instanz der HttpWebResponse-Klasse. Initializes a new instance of the HttpWebResponse class.

HttpWebResponse(SerializationInfo, StreamingContext) HttpWebResponse(SerializationInfo, StreamingContext) HttpWebResponse(SerializationInfo, StreamingContext) HttpWebResponse(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der HttpWebResponse-Klasse aus der angegebenen SerializationInfo-Instanz und der StreamingContext-Instanz. Initializes a new instance of the HttpWebResponse class from the specified SerializationInfo and StreamingContext instances.

Eigenschaften

CharacterSet CharacterSet CharacterSet CharacterSet

Ruft den Zeichensatz der Antwort ab. Gets the character set of the response.

ContentEncoding ContentEncoding ContentEncoding ContentEncoding

Ruft die Methode ab, die zum Codieren des Antworttexts verwendet wird. Gets the method that is used to encode the body of the response.

ContentLength ContentLength ContentLength ContentLength

Ruft die Länge des von der Anforderung zurückgegebenen Inhalts ab. Gets the length of the content returned by the request.

ContentType ContentType ContentType ContentType

Ruft den Inhaltstyp der Antwort ab. Gets the content type of the response.

Cookies Cookies Cookies Cookies

Ruft die dieser Antwort zugeordneten Cookies ab oder legt diese fest. Gets or sets the cookies that are associated with this response.

Headers Headers Headers Headers

Ruft die Header ab, die dieser Antwort vom Server zugeordnet sind. Gets the headers that are associated with this response from the server.

IsFromCache IsFromCache IsFromCache IsFromCache

Ruft einen Boolean-Wert ab, der angibt, ob diese Antwort aus dem Cache abgerufen wurde. Gets a Boolean value that indicates whether this response was obtained from the cache.

(Inherited from WebResponse)
IsMutuallyAuthenticated IsMutuallyAuthenticated IsMutuallyAuthenticated IsMutuallyAuthenticated

Ruft einen Boolean-Wert ab, der angibt, ob sowohl Client als auch Server authentifiziert wurden. Gets a Boolean value that indicates whether both client and server were authenticated.

LastModified LastModified LastModified LastModified

Ruft das Datum und die Uhrzeit der letzten Änderung des Inhalts der Antwort ab. Gets the last date and time that the contents of the response were modified.

Method Method Method Method

Ruft die zum Zurückgeben der Antwort verwendete Methode ab. Gets the method that is used to return the response.

ProtocolVersion ProtocolVersion ProtocolVersion ProtocolVersion

Ruft die in der Antwort verwendete Version des HTTP-Protokolls ab. Gets the version of the HTTP protocol that is used in the response.

ResponseUri ResponseUri ResponseUri ResponseUri

Ruft den URI der Internetressource ab, die die Anforderung beantwortet hat. Gets the URI of the Internet resource that responded to the request.

Server Server Server Server

Ruft den Namen des Servers ab, der die Antwort gesendet hat. Gets the name of the server that sent the response.

StatusCode StatusCode StatusCode StatusCode

Ruft den Status der Antwort ab. Gets the status of the response.

StatusDescription StatusDescription StatusDescription StatusDescription

Ruft die mit der Antwort zurückgegebene Statusbeschreibung ab. Gets the status description returned with the response.

SupportsHeaders SupportsHeaders SupportsHeaders SupportsHeaders

Ruft einen Wert ab, der angibt, ob Header unterstützt werden. Gets a value that indicates whether headers are supported.

Methoden

Close() Close() Close() Close()

Schließt den Antwortstream. Closes the response stream.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt die vom WebResponse-Objekt verwendeten nicht verwalteten Ressourcen frei. Releases the unmanaged resources used by the WebResponse object.

(Inherited from WebResponse)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die vom HttpWebResponse verwendeten, nicht verwalteten Ressourcen frei und verwirft optional auch die verwalteten Ressourcen. Releases the unmanaged resources used by the HttpWebResponse, and optionally disposes of the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. Populates a SerializationInfo with the data needed to serialize the target object.

GetResponseHeader(String) GetResponseHeader(String) GetResponseHeader(String) GetResponseHeader(String)

Ruft den Inhalt eines Headers ab, der mit der Antwort zurückgegeben wurde. Gets the contents of a header that was returned with the response.

GetResponseStream() GetResponseStream() GetResponseStream() GetResponseStream()

Ruft den Stream ab, der zum Lesen des Textkörpers der Serverantwort verwendet wird. Gets the stream that is used to read the body of the response from the server.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()
ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serialisiert diese Instanz in das angegebene SerializationInfo-Objekt. Serializes this instance into the specified SerializationInfo object.

Gilt für:

Siehe auch