1 out of 8 rated this helpful - Rate this topic

WebResponse Class

.NET Framework 4.5

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

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

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

Syntax

C++

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

The WebResponse type exposes the following members.

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.

Top

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.

Top

Methods

	Name	Description
	Close	When overridden by a descendant class, closes the response stream.
	CreateObjRef	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 a hash function for a particular type. (Inherited from Object.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetObjectData	Infrastructure. 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.)

Top

Explicit Interface Implementations

	Name	Description
	IDisposable.Dispose	Infrastructure. When overridden in a derived class, releases all resources used by the WebResponse.
	ISerializable.GetObjectData	Infrastructure. Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

Top

Remarks

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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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.

Reference

System.Net Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)