WebResponse Class

Definition

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

public abstract class WebResponse : MarshalByRefObject, IDisposable, System.Runtime.Serialization.ISerializable
Inheritance
Derived
Implements

Inherited Members

System.MarshalByRefObject

System.Object

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.

Constructors

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

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.

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.

GetObjectData(SerializationInfo, StreamingContext)

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.

Explicit Interface Implementations

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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