System.Web 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Object

The methods and properties of the class are exposed through the Request properties of the , , , and classes.

To access data from the , , , or collections, you can write Request["key"], as shown in the example for the property.

Unicode support for class members requires IIS version 6.0 or later.

Enables ASP.NET to read the HTTP values sent by a client during a Web request.

- Constructor

  You do not need to create your own instance of the class. The methods and properties of the class are exposed through the Request property of the , , , and classes.

  Initializes an object.

  The name of the file associated with the request.
  Information regarding the URL of the current request.
  The entire query string sent with the request (everything after the'?').
  1.0.5000.0
  2.0.0.0
- Property
  System.String[] To be added: an object of type 'string []' To be added

  Gets a string array of client-supported MIME accept types.

  1.0.5000.0
  2.0.0.0
- Property
  2.0.0.0
  System.String To be added.

  The property assigns a long-lived unique identifier to a non-authenticated user, which can be used to track the user or assign profile properties to that user without storing data in a Session object. By default, the property is tracked using a cookie, but it can be set to use the URI when the attribute in the anonymous identification configuration section is set to either the , , or value. You must explicitly clear the cookie if you no longer want it available, for example when an anonymous user is authenticated.

  Anonymous identification is used when there is a need to identify entities that are not authenticated and when authorization is required. For more information, see anonymousIdentification Element (ASP.NET Settings Schema)

  Gets the anonymous identifier for the user, if present.

- Property
  System.String To be added: an object of type 'string'

  Use this property to construct a URL relative to the application root from a page or Web user control that is not in the root directory. This allows pages and shared controls that exist at different levels of a directory structure to use the same code to link to resources at fixed locations in the application.

  Gets the ASP.NET application's virtual application root path on the server.

  1.0.5000.0
  2.0.0.0
- Property
  2.0.0.0
  System.String To be added.

  Use this property to provide URL information that will stay the same even if the application changes location. This allows the same URL-mapping code to be used in a test environment and in the final deployment environment, or to be used by copies of Web applications in different domains.

  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").

- Method
  System.Byte[] ``

  The method is provided for compatibility with ASP.

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

  A byte array.

  The number of bytes to read. 1.0.5000.0 2.0.0.0
- Property
  System.Web.HttpBrowserCapabilities To be added: an object of type 'HttpBrowserCapabilities' To be added

  Gets or sets information about the requesting client's browser capabilities.

  1.0.5000.0
  2.0.0.0
- Property
  System.Web.HttpClientCertificate To be added: an object of type 'HttpClientCertificate' To be added

  Gets the current request's client security certificate.

  1.0.5000.0
  2.0.0.0
- Property
  System.Text.Encoding The used for the request body.

  Default content encoding can be specified in the globalization Element (ASP.NET Settings Schema) of a configuration file. If content encoding is also specified by the client, the default configuration settings are overridden.

  Gets or sets the character set of the entity-body.

  1.0.5000.0
  2.0.0.0
- Property
  System.Int32 The size of the data that has been attached to this request or zero if this information was not provided.

  Specifies the length, in bytes, of content sent by the client.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string' To be added

  Gets or sets the MIME content type of the incoming request.

  1.0.5000.0
  2.0.0.0
- Property
  System.Web.HttpCookieCollection The return value is a collection of the cookies.

  ASP.NET includes two intrinsic cookie collections. The collection accessed through the collection of contains cookies transmitted by the client to the server in the Cookie header. The collection accessed through the collection of contains new cookies created on the server and transmitted to the client in the Set-Cookie header.

  After you add a cookie by using the collection, the cookie is immediately available in the collection, even if the response has not been sent to the client.

  Gets a collection of cookies sent by the client.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  returns the file path to the currently executing page handler. For redirect scenarios using and methods this means that the property returns the path to the page redirected to (child page). However, when the client is redirected to another page, the property returns the path to the original page.

  Gets the virtual path of the current request.

  1.0.5000.0
  2.0.0.0
- Property
  System.String The path as a string

  The property does not include the trailer. For example, for the URL http://www.contoso.com/virdir/page.html/tail, the value is /virdir/page.html.

  Gets the virtual path of the current request.

  1.0.5000.0
  2.0.0.0
- Property
  System.Web.HttpFileCollection To be added: an object of type 'HttpFileCollection'

  The file collection is populated only when the HTTP request Content-Type value is "multipart/form-data".

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

  1.0.5000.0
  2.0.0.0
- Property
  System.IO.Stream a To be added

  Gets or sets the filter to use when reading the current input stream.

  1.0.5000.0
  2.0.0.0
- Property
  System.Collections.Specialized.NameValueCollection a

  The property is populated when the HTTP request Content-Type value is either "application/x-www-form-urlencoded" or "multipart/form-data".

  Gets a collection of form variables.

  1.0.5000.0
  2.0.0.0
- Property
  System.Collections.Specialized.NameValueCollection a

  For a listing of all possible headers, see Request Header Fields on the W3C Web site.

  Gets a collection of HTTP headers.

  1.0.5000.0
  2.0.0.0
- Property
  System.String The method used to trigger this request. The values are typically GET or POST but any valid HTTP verb can be returned as well as user-defined verbs or application-defined verbs.

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

  1.0.5000.0
  2.0.0.0
- Property
  System.IO.Stream a The stream returned is a seekable stream. Because of this the whole stream lives in memory for the duration of the request.

  The runtime puts a cap on the size of the maximum upload to avoid possible denials of service, this is configured in the <system.web> section of the machine config or the per-application web.config file in the <httpRuntime> subsection with the attribute "maxRequestLength", a value expressed in kilobytes.

  The stream is created on the first access to this property. Module authors and IHttpHandler developers can work around this by using the method from the passing a to get direct access to the input data.

  Gets the contents of the incoming HTTP entity body.

  1.0.5000.0
  2.0.0.0
- Property
  System.Boolean To be added: an object of type 'bool' To be added

  Gets a value indicating whether the request has been authenticated.

  1.0.5000.0
  2.0.0.0
- Property
  2.0.0.0
  System.Boolean To be added.

  The property returns true if the IP address of the request originator is 127.0.0.1 or if the IP address of the request is the same as the server's IP address.

  Gets a value indicating whether the request is from the local computer.

- Property
  System.Boolean returns true if the request is using https and false if not. To be added

  Gets a value indicating whether the HTTP connection uses secure sockets (that is, HTTPS).

  1.0.5000.0
  2.0.0.0
- Property
  System.String `` To be added. To be added. To be added. To be added. 1.0.5000.0 2.0.0.0
- Property
  2.0.0.0
  System.Security.Principal.WindowsIdentity To be added.

  The property exposes the properties and methods of the object for the currently connected user to Microsoft Internet Information Services (IIS). The instance of the class that is exposed by tracks the IIS request token and provides easy access to this token for the current HTTP request being processed inside of ASP.NET. An instance of the class is automatically created so it does not need to be constructed to in order to gain access to its methods and properties.

  Gets the type for the current user.

- Method
  System.Int32[] `` To be added

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

  A two-dimensional array of integers.

  The name of the form image map. 1.0.5000.0 2.0.0.0
- Method
  System.String ``

  The property potentially contains sensitive information about the hosting environment. The return value should not be displayed to users.

  Maps the specified virtual path to a physical path.

  The physical path on the server specified by .

  The virtual path (absolute or relative) for the current request. 1.0.5000.0 2.0.0.0
- Method
  System.String `` `` ``

  The property potentially contains sensitive information about the hosting environment. The return value should not be displayed to users.

  Maps the specified virtual path to a physical path.

  The physical path on the server.

  The virtual path (absolute or relative) for the current request. The virtual base directory path used for relative resolution. true to indicate that may belong to another application; otherwise, false. 1.0.5000.0 2.0.0.0
- Property
  System.Collections.Specialized.NameValueCollection a

  Name-value pairs are added to the collection in the following order:

  Query-string parameters.

  Form fields.

  Cookies.

  Server variables.

  Gets a combined collection of , , , and items.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  The is the concatenation of the and the trailer. For example, for the URL http://www.contoso.com/virdir/page.html/tail, the is /virdir/page.html/tail.

  Gets the virtual path of the current request.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  For the URL Http://www.contoso.com/virdir/page.html/tail, the value is /tail.

  Gets additional path information for a resource with a URL extension.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string' To be added

  Gets the physical file system path of the currently executing server application's root directory.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  In redirect scenarios using and , the property returns the path to the original page. To find the physical path of the currently executing page use the method with the input argument set as the property.

  Gets the physical file system path corresponding to the requested URL.

  1.0.5000.0
  2.0.0.0
- Property
  System.Collections.Specialized.NameValueCollection a To be added

  Gets the collection of HTTP query string variables.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  The raw URL is defined as the part of the URL following the domain information. In the URL string http://www.contoso.com/articles/recent.aspx, the raw URL is /articles/recent.aspx. The raw URL includes the query string, if present.

  Gets the raw URL of the current request.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string' To be added

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

  1.0.5000.0
  2.0.0.0
- Method
  System.Void `` ``

  Saving the request context to disk can be useful in debugging.

  Saves an HTTP request to disk.

  The physical drive path. A Boolean value specifying whether an HTTP header should be saved to disk. 1.0.5000.0 2.0.0.0
- Property
  System.Collections.Specialized.NameValueCollection a

  For a list of server variables supported by IIS, see IIS Server Variables.

  Gets a collection of Web server variables.

  1.0.5000.0
  2.0.0.0
- Property
  System.Int32 To be added: an object of type 'int' To be added

  Gets the number of bytes in the current input stream.

  1.0.5000.0
  2.0.0.0
- Property
  System.Uri To be added: an object of type 'Uri' To be added

  Gets information about the URL of the current request.

  1.0.5000.0
  2.0.0.0
- Property
  System.Uri To be added: an object of type 'Uri' To be added

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

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string' To be added

  Gets the raw user agent string of the client browser.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string' To be added

  Gets the IP host address of the remote client.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string' To be added

  Gets the DNS name of the remote client.

  1.0.5000.0
  2.0.0.0
- Property
  System.String[] To be added: an object of type 'string []' To be added

  Gets a sorted string array of client language preferences.

  1.0.5000.0
  2.0.0.0
- Method
  System.Void

  The class uses input validation flags to track whether to perform validation on the request collections accessed through the , , and properties. The method sets these flags so that when the get accessors for the , , or property are invoked, input validation is performed. Validation works by checking all input data against a hard-coded list of potentially dangerous data.

  If the validation feature is enabled by page directive or configuration, this method is called during the page's ProcessRequest processing phase. The method can be called by your code if the validation feature is not enabled.

  Causes validation to occur for the collections accessed through the , , and properties.

  1.0.5000.0
  2.0.0.0