Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
HttpRequestWrapper Class
Collapse the table of content
Expand the table of content

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 propertyCurrentExecutionFilePathExtensionGets the extension of the file name that is specified in the CurrentExecutionFilePath property. (Overrides HttpRequestBase.CurrentExecutionFilePathExtension.)
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.)
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 propertyReadEntityBodyModeGets a value that indicates whether the request entity body has been read, and if so, how it was read. (Overrides HttpRequestBase.ReadEntityBodyMode.)
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 propertyTimedOutTokenGets a CancellationToken object that is tripped when a request times out. (Overrides HttpRequestBase.TimedOutToken.)
Public propertyTlsTokenBindingInfoGets the Tls token binding information. (Overrides HttpRequestBase.TlsTokenBindingInfo.)
Public propertyTotalBytesGets the number of bytes in the current input stream. (Overrides HttpRequestBase.TotalBytes.)
Public propertyUnvalidatedGets an access to HTTP request values without triggering request validation. (Overrides HttpRequestBase.Unvalidated.)
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 methodAbortForcibly terminates the underlying TCP connection, causing any outstanding I/O to fail. (Overrides HttpRequestBase.Abort().)
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 methodGetBufferedInputStreamGets a Stream object that can be used to read the incoming HTTP entity body. (Overrides HttpRequestBase.GetBufferedInputStream().)
Public methodGetBufferlessInputStream()Gets a Stream object that can be used to read the incoming HTTP entity body. (Overrides HttpRequestBase.GetBufferlessInputStream().)
Public methodGetBufferlessInputStream(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. (Overrides HttpRequestBase.GetBufferlessInputStream(Boolean).)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodInsertEntityBody()Provides with a copy of the HTTP request entity body to IIS. (Overrides HttpRequestBase.InsertEntityBody().)
Public methodInsertEntityBody(Byte[], Int32, Int32)Provides IIS with a copy of the HTTP request entity body and with information about the request entity object. (Overrides HttpRequestBase.InsertEntityBody(Byte[], Int32, Int32).)
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).)
Public methodMapRawImageCoordinatesMaps an incoming image field form parameter into appropriate x and y coordinate values. (Overrides HttpRequestBase.MapRawImageCoordinates(String).)
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.6, 4.5, 4, 3.5 SP1

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