This documentation is archived and is not being maintained.

HttpRequestWrapper Class

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


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

public class HttpRequestWrapper : HttpRequestBase

The HttpRequestWrapper type exposes the following members.

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

Public propertyAcceptTypesGets an array of client-supported MIME accept types. (Overrides HttpRequestBase.AcceptTypes.)
Public propertyAnonymousIDGets the anonymous identifier for the user, if it is available. (Overrides HttpRequestBase.AnonymousID.)
Public propertyApplicationPathGets the virtual path of the root of the ASP.NET application on the server. (Overrides HttpRequestBase.ApplicationPath.)
Public propertyAppRelativeCurrentExecutionFilePathGets the virtual path of the application root and makes it relative by using the tilde (~) notation for the application root (as in "~/page.aspx"). (Overrides HttpRequestBase.AppRelativeCurrentExecutionFilePath.)
Public propertyBrowserGets information about the requesting client's browser capabilities. (Overrides HttpRequestBase.Browser.)
Public propertyClientCertificateGets the current request's client security certificate. (Overrides HttpRequestBase.ClientCertificate.)
Public propertyContentEncodingGets or sets the character set of the data that was provided by the client. (Overrides HttpRequestBase.ContentEncoding.)
Public propertyContentLengthGets the length, in bytes, of content that was sent by the client. (Overrides HttpRequestBase.ContentLength.)
Public propertyContentTypeGets or sets the MIME content type of the request. (Overrides HttpRequestBase.ContentType.)
Public propertyCookiesGets the collection of cookies that were sent by the client. (Overrides HttpRequestBase.Cookies.)
Public propertyCurrentExecutionFilePathGets the virtual path of the current request. (Overrides HttpRequestBase.CurrentExecutionFilePath.)
Public propertyFilePathGets the virtual path of the current request. (Overrides HttpRequestBase.FilePath.)
Public propertyFilesGets the collection of files that were uploaded by the client, in multipart MIME format. (Overrides HttpRequestBase.Files.)
Public propertyFilterGets or sets the filter to use when the current input stream is being read. (Overrides HttpRequestBase.Filter.)
Public propertyFormGets the collection of form variables that were sent by the client. (Overrides HttpRequestBase.Form.)
Public propertyHeadersGets the collection of HTTP headers that were sent by the client. (Overrides HttpRequestBase.Headers.)
Public propertyHttpChannelBindingGets the ChannelBinding object of the current HttpWorkerRequest instance. (Overrides HttpRequestBase.HttpChannelBinding.)
Public propertyHttpMethodGets the HTTP data-transfer method (such as GET, POST, or HEAD) that was used by the client. (Overrides HttpRequestBase.HttpMethod.)
Public propertyInputStreamGets the contents of the incoming HTTP entity body. (Overrides HttpRequestBase.InputStream.)
Public propertyIsAuthenticatedGets a value that indicates whether the request has been authenticated. (Overrides HttpRequestBase.IsAuthenticated.)
Public propertyIsLocalGets a value that indicates whether the request is from the local computer. (Overrides HttpRequestBase.IsLocal.)
Public propertyIsSecureConnectionGets a value that indicates whether the HTTP connection uses secure sockets (HTTPS protocol). (Overrides HttpRequestBase.IsSecureConnection.)
Public propertyItemGets the specified object from the Cookies, Form, QueryString, or ServerVariables collections. (Overrides HttpRequestBase.Item[String].)
Public propertyLogonUserIdentityGets the WindowsIdentity type for the current user. (Overrides HttpRequestBase.LogonUserIdentity.)
Public propertyParamsGets a combined collection of QueryString, Form, ServerVariables, and Cookies items. (Overrides HttpRequestBase.Params.)
Public propertyPathGets the virtual path of the current request. (Overrides HttpRequestBase.Path.)
Public propertyPathInfoGets additional path information for a resource that has a URL extension. (Overrides HttpRequestBase.PathInfo.)
Public propertyPhysicalApplicationPathGets the physical file-system path of the current application's root directory. (Overrides HttpRequestBase.PhysicalApplicationPath.)
Public propertyPhysicalPathGets the physical file-system path of the requested resource. (Overrides HttpRequestBase.PhysicalPath.)
Public propertyQueryStringGets the collection of HTTP query-string variables. (Overrides HttpRequestBase.QueryString.)
Public propertyRawUrlGets the complete URL of the current request. (Overrides HttpRequestBase.RawUrl.)
Public propertyRequestContextGets the RequestContext instance of the current request. (Overrides HttpRequestBase.RequestContext.)
Public propertyRequestTypeGets or sets the HTTP data-transfer method (GET or POST) that was used by the client. (Overrides HttpRequestBase.RequestType.)
Public propertyServerVariablesGets a collection of Web server variables. (Overrides HttpRequestBase.ServerVariables.)
Public propertyTotalBytesGets the number of bytes in the current input stream. (Overrides HttpRequestBase.TotalBytes.)
Public propertyUrlGets information about the URL of the current request. (Overrides HttpRequestBase.Url.)
Public propertyUrlReferrerGets information about the URL of the client request that linked to the current URL. (Overrides HttpRequestBase.UrlReferrer.)
Public propertyUserAgentGets the complete user-agent string of the client. (Overrides HttpRequestBase.UserAgent.)
Public propertyUserHostAddressGets the IP host address of the client. (Overrides HttpRequestBase.UserHostAddress.)
Public propertyUserHostNameGets the DNS name of the client. (Overrides HttpRequestBase.UserHostName.)
Public propertyUserLanguagesGets a sorted array of client language preferences. (Overrides HttpRequestBase.UserLanguages.)

Public methodBinaryReadPerforms a binary read of a specified number of bytes from the current input stream. (Overrides HttpRequestBase.BinaryRead(Int32).)
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodMapImageCoordinatesMaps an incoming image-field form parameter to appropriate x-coordinate and y-coordinate values. (Overrides HttpRequestBase.MapImageCoordinates(String).)
Public methodMapPath(String)Maps the specified virtual path to a physical path on the server. (Overrides HttpRequestBase.MapPath(String).)
Public methodMapPath(String, String, Boolean)Maps the specified virtual path to a physical path on the server. (Overrides HttpRequestBase.MapPath(String, String, Boolean).)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSaveAsSaves an HTTP request to disk. (Overrides HttpRequestBase.SaveAs(String, Boolean).)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodValidateInputCauses validation to occur for the collections that are accessed through the Cookies, Form, and QueryString properties. (Overrides HttpRequestBase.ValidateInput().)

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.

.NET Framework

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.