The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WebResponse Class

.NET Framework (current version)

Other Versions

Provides a response from a Uniform Resource Identifier (URI). This is an abstract class.

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

Inheritance Hierarchy

System::Object
System::MarshalByRefObject
System.Net::WebResponse
System.IO.Packaging::PackWebResponse
System.Net::FileWebResponse
System.Net::FtpWebResponse
System.Net::HttpWebResponse

Syntax

C++

[SerializableAttribute]
public ref class WebResponse abstract : MarshalByRefObject, ISerializable, 
	IDisposable

Constructors

	Name	Description
	WebResponse()	Initializes a new instance of the WebResponse class.
	WebResponse(SerializationInfo^, StreamingContext)	Initializes a new instance of the WebResponse class from the specified instances of the SerializationInfo and StreamingContext classes.

Properties

	Name	Description
	ContentLength	When overridden in a descendant class, gets or sets the content length of data being received.
	ContentType	When overridden in a derived class, gets or sets the content type of the data being received.
	Headers	When overridden in a derived class, gets a collection of header name-value pairs associated with this request.
	IsFromCache	Gets a Boolean value that indicates whether this response was obtained from the cache.
	IsMutuallyAuthenticated	Gets a Boolean value that indicates whether mutual authentication occurred.
	ResponseUri	When overridden in a derived class, gets the URI of the Internet resource that actually responded to the request.
	SupportsHeaders	Gets a value that indicates if headers are supported.

Methods

	Name	Description
	Close()	When overridden by a descendant class, closes the response stream.
	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.
	Dispose(Boolean)	Releases the unmanaged resources used by the WebResponse object, and optionally disposes of the managed resources.
	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 that is needed to serialize the target object.
	GetResponseStream()	When overridden in a descendant class, returns the data stream from the Internet resource.
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	InitializeLifetimeService()	Obtains a lifetime service object to control the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	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.)

Explicit Interface Implementations

	Name	Description
	ISerializable::GetObjectData(SerializationInfo^, StreamingContext)	This API supports the product infrastructure and is not intended to be used directly from your code. Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

The WebResponse class is the abstract base class from which protocol-specific response classes are derived. Applications can participate in request and response transactions in a protocol-agnostic manner using instances of the WebResponse class while protocol-specific classes derived from WebResponse carry out the details of the request.

Client applications do not create WebResponse objects directly; they are created by calling the GetResponse method on a WebRequest instance.

Notes to Inheritors:

When you inherit from WebResponse, you must override the following members: ContentLength, ContentType, GetResponseStream, ResponseUri, and Headers.

Examples

The following example creates a WebResponse instance from a WebRequest.

C++

// Initialize the WebRequest.
WebRequest^ myRequest = WebRequest::Create( "http://www.contoso.com" );

// Return the response. 
WebResponse^ myResponse = myRequest->GetResponse();

// Code to use the WebResponse goes here.

// Close the response to free resources.
myResponse->Close();

Version Information

Universal Windows Platform
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

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

English	Dansk	Deutsch	Español
Français	Italiano	Nederlands	Polski
Português	Svenska	Türkçe	Pусский
日本語	한국어	简体中文	繁體中文