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) |
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) |
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) |
Populates a SerializationInfo instance with the data that is needed to serialize WebResponse. |