HttpRequestWrapper Class

Definition

Encapsulates the HTTP intrinsic object that enables ASP.NET to read the HTTP values that are sent by a client during a Web request.

public ref class HttpRequestWrapper : System::Web::HttpRequestBase
public class HttpRequestWrapper : System.Web.HttpRequestBase
type HttpRequestWrapper = class
    inherit HttpRequestBase
Public Class HttpRequestWrapper
Inherits HttpRequestBase
Inheritance
HttpRequestWrapper

Remarks

The HttpRequestWrapper class derives from the HttpRequestBase class and serves as a wrapper for the HttpRequest class. This class exposes the functionality of the HttpRequest class and exposes the HttpRequestBase type. The HttpRequestBase class enables you to replace the original implementation of the HttpRequest class in your application with a custom implementation, such as when you perform unit testing outside the ASP.NET pipeline.

Constructors

HttpRequestWrapper(HttpRequest)

Initializes a new instance of the HttpRequestWrapper class by using the specified request object.

Properties

AcceptTypes

Gets an array of client-supported MIME accept types.

AnonymousID

Gets the anonymous identifier for the user, if it is available.

ApplicationPath

Gets the virtual path of the root of the ASP.NET application on the server.

AppRelativeCurrentExecutionFilePath

Gets the virtual path of the application root and makes it relative by using the tilde (~) notation for the application root (as in "~/page.aspx").

Browser

Gets information about the requesting client's browser capabilities.

ClientCertificate

Gets the current request's client security certificate.

ContentEncoding

Gets or sets the character set of the data that was provided by the client.

ContentLength

Gets the length, in bytes, of content that was sent by the client.

ContentType

Gets or sets the MIME content type of the request.

Cookies

Gets the collection of cookies that were sent by the client.

CurrentExecutionFilePath

Gets the virtual path of the current request.

CurrentExecutionFilePathExtension

Gets the extension of the file name that is specified in the CurrentExecutionFilePath property.

CurrentExecutionFilePathExtension

When implemented in a derived class, gets the extension of the file name that is specified in the CurrentExecutionFilePath property.

(Inherited from HttpRequestBase)
FilePath

Gets the virtual path of the current request.

Files

Gets the collection of files that were uploaded by the client, in multipart MIME format.

Filter

Gets or sets the filter to use when the current input stream is being read.

Form

Gets the collection of form variables that were sent by the client.

Headers

Gets the collection of HTTP headers that were sent by the client.

HttpChannelBinding

Gets the ChannelBinding object of the current HttpWorkerRequest instance.

HttpChannelBinding

When overridden in a derived class, gets the ChannelBinding object of the current HttpWorkerRequest instance.

(Inherited from HttpRequestBase)
HttpMethod

Gets the HTTP data-transfer method (such as GET, POST, or HEAD) that was used by the client.

InputStream

Gets the contents of the incoming HTTP entity body.

IsAuthenticated

Gets a value that indicates whether the request has been authenticated.

IsLocal

Gets a value that indicates whether the request is from the local computer.

IsSecureConnection

Gets a value that indicates whether the HTTP connection uses secure sockets (HTTPS protocol).

Item[String]

Gets the specified object from the Cookies, Form, QueryString, or ServerVariables collections.

LogonUserIdentity

Gets the WindowsIdentity type for the current user.

Params

Gets a combined collection of QueryString, Form, ServerVariables, and Cookies items.

Path

Gets the virtual path of the current request.

PathInfo

Gets additional path information for a resource that has a URL extension.

PhysicalApplicationPath

Gets the physical file-system path of the current application's root directory.

PhysicalPath

Gets the physical file-system path of the requested resource.

QueryString

Gets the collection of HTTP query-string variables.

RawUrl

Gets the complete URL of the current request.

ReadEntityBodyMode

Gets a value that indicates whether the request entity body has been read, and if so, how it was read.

ReadEntityBodyMode

When implemented in a derived class, gets a value that indicates whether the request entity body has been read, and if so, how it was read.

(Inherited from HttpRequestBase)
RequestContext

Gets the RequestContext instance of the current request.

RequestContext

When overridden in a derived class, gets the RequestContext instance of the current request.

(Inherited from HttpRequestBase)
RequestType

Gets or sets the HTTP data-transfer method (GET or POST) that was used by the client.

ServerVariables

Gets a collection of Web server variables.

TimedOutToken

Gets a CancellationToken object that is tripped when a request times out.

TimedOutToken

When implemented in a derived class, gets a CancellationToken object that is tripped when a request times out.

(Inherited from HttpRequestBase)
TlsTokenBindingInfo

Gets the Tls token binding information.

TlsTokenBindingInfo

Gets or sets the token binding information for this instance.

(Inherited from HttpRequestBase)
TotalBytes

Gets the number of bytes in the current input stream.

Unvalidated

Gets an access to HTTP request values without triggering request validation.

Unvalidated

When implemented in a derived class, provides access to HTTP request values without triggering request validation.

(Inherited from HttpRequestBase)
Url

Gets information about the URL of the current request.

UrlReferrer

Gets information about the URL of the client request that linked to the current URL.

UserAgent

Gets the complete user-agent string of the client.

UserHostAddress

Gets the IP host address of the client.

UserHostName

Gets the DNS name of the client.

UserLanguages

Gets a sorted array of client language preferences.

Methods

Abort()

Forcibly terminates the underlying TCP connection, causing any outstanding I/O to fail.

Abort()

Forcibly terminates the underlying TCP connection, causing any outstanding I/O to fail.

(Inherited from HttpRequestBase)
BinaryRead(Int32)

Performs a binary read of a specified number of bytes from the current input stream.

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBufferedInputStream()

Gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferedInputStream()

When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body.

(Inherited from HttpRequestBase)
GetBufferlessInputStream()

Gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferlessInputStream()

When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request length limit that is set in the MaxRequestLength property.

(Inherited from HttpRequestBase)
GetBufferlessInputStream(Boolean)

Gets a Stream object that can be used to read the incoming HTTP entity body, , optionally disabling the request length limit that is set in the MaxRequestLength property.

GetBufferlessInputStream(Boolean)

When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request length limit that is set in the MaxRequestLength property.

(Inherited from HttpRequestBase)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
InsertEntityBody()

Provides with a copy of the HTTP request entity body to IIS.

InsertEntityBody()

When implemented in a derived class, provides a copy of the HTTP request entity body to IIS.

(Inherited from HttpRequestBase)
InsertEntityBody(Byte[], Int32, Int32)

Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

InsertEntityBody(Byte[], Int32, Int32)

When implemented in a derived class, provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

(Inherited from HttpRequestBase)
MapImageCoordinates(String)

Maps an incoming image-field form parameter to appropriate x-coordinate and y-coordinate values.

MapPath(String)

Maps the specified virtual path to a physical path on the server.

MapPath(String, String, Boolean)

Maps the specified virtual path to a physical path on the server.

MapRawImageCoordinates(String)

Maps an incoming image field form parameter into appropriate x and y coordinate values.

MapRawImageCoordinates(String)

Maps an incoming image field form parameter into appropriate x and y coordinate values.

(Inherited from HttpRequestBase)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
SaveAs(String, Boolean)

Saves an HTTP request to disk.

ToString()

Returns a string that represents the current object.

(Inherited from Object)
ValidateInput()

Causes validation to occur for the collections that are accessed through the Cookies, Form, and QueryString properties.

Applies to