HttpWebResponse Class
Provides an HTTP-specific implementation of the WebResponse class.
Assembly: System (in System.dll)
| Name | Description | |
|---|---|---|
![]() | HttpWebResponse() | Obsolete. Initializes a new instance of the HttpWebResponse class. |
![]() | HttpWebResponse(SerializationInfo^, StreamingContext) | Obsolete. Initializes a new instance of the HttpWebResponse class from the specified SerializationInfo and StreamingContext instances. |
| Name | Description | |
|---|---|---|
![]() | CharacterSet | Gets the character set of the response. |
![]() | ContentEncoding | Gets the method that is used to encode the body of the response. |
![]() | ContentLength | Gets the length of the content returned by the request.(Overrides WebResponse::ContentLength.) |
![]() | ContentType | Gets the content type of the response.(Overrides WebResponse::ContentType.) |
![]() | Cookies | Gets or sets the cookies that are associated with this response. |
![]() | Headers | Gets the headers that are associated with this response from the server.(Overrides WebResponse::Headers.) |
![]() | IsFromCache | Gets a Boolean value that indicates whether this response was obtained from the cache.(Inherited from WebResponse.) |
![]() | IsMutuallyAuthenticated | Gets a Boolean value that indicates whether both client and server were authenticated.(Overrides WebResponse::IsMutuallyAuthenticated.) |
![]() | LastModified | Gets the last date and time that the contents of the response were modified. |
![]() | Method | Gets the method that is used to return the response. |
![]() | ProtocolVersion | Gets the version of the HTTP protocol that is used in the response. |
![]() | ResponseUri | Gets the URI of the Internet resource that responded to the request.(Overrides WebResponse::ResponseUri.) |
![]() | Server | Gets the name of the server that sent the response. |
![]() | StatusCode | Gets the status of the response. |
![]() | StatusDescription | Gets the status description returned with the response. |
![]() | SupportsHeaders | Gets a value that indicates if headers are supported.(Overrides WebResponse::SupportsHeaders.) |
| Name | Description | |
|---|---|---|
![]() | Close() | Closes the response stream.(Overrides WebResponse::Close().) |
![]() | CreateObjRef(Type^) | 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() | Releases the unmanaged resources used by the WebResponse object.(Inherited from WebResponse.) |
![]() | Dispose(Boolean) | Releases the unmanaged resources used by the HttpWebResponse, and optionally disposes of the managed resources.(Overrides WebResponse::Dispose(Boolean).) |
![]() | Equals(Object^) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetLifetimeService() | Retrieves the current lifetime service object that controls the lifetime policy for this instance.(Inherited from MarshalByRefObject.) |
![]() | GetObjectData(SerializationInfo^, StreamingContext) | This API supports the product infrastructure and is not intended to be used directly from your code. Populates a SerializationInfo with the data needed to serialize the target object.(Overrides WebResponse::GetObjectData(SerializationInfo^, StreamingContext).) |
![]() | GetResponseHeader(String^) | Gets the contents of a header that was returned with the response. |
![]() | GetResponseStream() | Gets the stream that is used to read the body of the response from the server.(Overrides WebResponse::GetResponseStream().) |
![]() | GetType() | |
![]() | InitializeLifetimeService() | Obtains a lifetime service object to control the lifetime policy for this instance.(Inherited from MarshalByRefObject.) |
![]() | MemberwiseClone() | |
![]() | MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object.(Inherited from MarshalByRefObject.) |
![]() | ToString() | Returns a string that represents the current object.(Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ISerializable::GetObjectData(SerializationInfo^, StreamingContext) | This API supports the product infrastructure and is not intended to be used directly from your code. Serializes this instance into the specified SerializationInfo object. |
This class contains support for HTTP-specific uses of the properties and methods of the WebResponse class. The HttpWebResponse class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.
Note |
|---|
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. |
You should never directly create an instance of the HttpWebResponse class. Instead, use the instance returned by a call to HttpWebRequest::GetResponse. You must call either the Stream::Close or the HttpWebResponse::Close method to close the response and release the connection for reuse. It is not necessary to call both Stream::Close and HttpWebResponse::Close, but doing so does not cause an error.
Common header information returned from the Internet resource is exposed as properties of the class. See the following table for a complete list. Other headers can be read from the Headers property as name/value pairs.
The following table shows the common HTTP headers that are available through properties of the HttpWebResponse class.
Header | Property |
|---|---|
Content-Encoding | |
Content-Length | |
Content-Type | |
Last-Modified | |
Server |
The contents of the response from the Internet resource are returned as a Stream by calling the GetResponseStream method.
The following example returns an HttpWebResponse from an HttpWebRequest.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.





