WebResponse Class

Definition

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

public ref class WebResponse abstract : IDisposable
public ref class WebResponse abstract : MarshalByRefObject, IDisposable, System::Runtime::Serialization::ISerializable
public abstract class WebResponse : IDisposable
public abstract class WebResponse : MarshalByRefObject, IDisposable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public abstract class WebResponse : MarshalByRefObject, IDisposable, System.Runtime.Serialization.ISerializable
type WebResponse = class
    interface IDisposable
type WebResponse = class
    inherit MarshalByRefObject
    interface IDisposable
    interface ISerializable
type WebResponse = class
    inherit MarshalByRefObject
    interface ISerializable
    interface IDisposable
[<System.Serializable>]
type WebResponse = class
    inherit MarshalByRefObject
    interface ISerializable
    interface IDisposable
Public MustInherit Class WebResponse
Implements IDisposable
Public MustInherit Class WebResponse
Inherits MarshalByRefObject
Implements IDisposable, ISerializable
Inheritance
WebResponse
Inheritance
Derived
Attributes
Implements

Examples

The following example creates a WebResponse instance from a WebRequest.

// 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();
// 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();
' Initialize the WebRequest.
Dim myRequest As WebRequest = WebRequest.Create("http://www.contoso.com")

' Return the response. 
Dim myResponse As WebResponse = myRequest.GetResponse()

' Code to use the WebResponse goes here.
' Close the response to free resources.
myResponse.Close()

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 Implementers

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

Constructors

WebResponse()

Initializes a new instance of the WebResponse class.

WebResponse(SerializationInfo, StreamingContext)
Obsolete.

Initializes a new instance of the WebResponse class from the specified instances of the SerializationInfo and StreamingContext classes.

Properties

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

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)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetLifetimeService()
Obsolete.

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

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()
Obsolete.

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

IDisposable.Dispose()

When overridden in a derived class, releases all resources used by the WebResponse.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)
Obsolete.

Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

Applies to