SimpleWorkerRequest Class
.NET Framework 4
Provides a simple implementation of the HttpWorkerRequest abstract class that can be used to host ASP.NET applications outside an Internet Information Services (IIS) application. You can employ SimpleWorkerRequest directly or extend it.
Namespace:
System.Web.Hosting
Assembly: System.Web (in System.Web.dll)
The SimpleWorkerRequest type exposes the following members.
| Name | Description | |
|---|---|---|
|
SimpleWorkerRequest(String, String, TextWriter) | Initializes a new instance of the SimpleWorkerRequest class when the target application domain has been created using the CreateApplicationHost method. |
|
|
SimpleWorkerRequest(String, String, String, String, TextWriter) | Initializes a new instance of the SimpleWorkerRequest class for use in an arbitrary application domain, when the user code creates an HttpContext (passing the SimpleWorkerRequest as an argument to the HttpContext constructor). |
| Name | Description | |
|---|---|---|
|
MachineConfigPath | Gets the full physical path to the Machine.config file. (Overrides HttpWorkerRequest.MachineConfigPath.) |
|
|
MachineInstallDirectory | Gets the physical path to the directory where the ASP.NET binaries are installed. (Overrides HttpWorkerRequest.MachineInstallDirectory.) |
|
|
RequestTraceIdentifier | Gets the corresponding Event Tracking for Windows trace ID for the current request. (Inherited from HttpWorkerRequest.) |
|
|
RootWebConfigPath | Gets the full physical path to the root Web.config file. (Overrides HttpWorkerRequest.RootWebConfigPath.) |
| Name | Description | |
|---|---|---|
|
|
CloseConnection | Terminates the connection with the client. (Inherited from HttpWorkerRequest.) |
|
|
EndOfRequest | Notifies the HttpWorkerRequest that request processing for the current request is complete. (Overrides HttpWorkerRequest.EndOfRequest().) |
|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
|
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
|
FlushResponse | Sends all pending response data to the client. (Overrides HttpWorkerRequest.FlushResponse(Boolean).) |
|
|
GetAppPath | Returns the virtual path to the currently executing server application. (Overrides HttpWorkerRequest.GetAppPath().) |
|
|
GetAppPathTranslated | Returns the UNC-translated path to the currently executing server application. (Overrides HttpWorkerRequest.GetAppPathTranslated().) |
|
|
GetAppPoolID | Infrastructure. When overridden in a derived class, returns the application pool ID for the current URL. (Inherited from HttpWorkerRequest.) |
|
|
GetBytesRead | Infrastructure. Gets the number of bytes read in from the client. (Inherited from HttpWorkerRequest.) |
|
|
GetClientCertificate | Infrastructure. When overridden in a derived class, gets the certification fields (specified in the X.509 standard) from a request issued by the client. (Inherited from HttpWorkerRequest.) |
|
|
GetClientCertificateBinaryIssuer | Infrastructure. Gets the certificate issuer, in binary format. (Inherited from HttpWorkerRequest.) |
|
|
GetClientCertificateEncoding | Infrastructure. When overridden in a derived class, returns the Encoding object in which the client certificate was encoded. (Inherited from HttpWorkerRequest.) |
|
|
GetClientCertificatePublicKey | Infrastructure. When overridden in a derived class, gets a PublicKey object associated with the client certificate. (Inherited from HttpWorkerRequest.) |
|
|
GetClientCertificateValidFrom | Infrastructure. When overridden in a derived class, gets the date when the certificate becomes valid. The date varies with international settings. (Inherited from HttpWorkerRequest.) |
|
|
GetClientCertificateValidUntil | Infrastructure. Gets the certificate expiration date. (Inherited from HttpWorkerRequest.) |
|
|
GetConnectionID | Infrastructure. When overridden in a derived class, returns the ID of the current connection. (Inherited from HttpWorkerRequest.) |
|
|
GetFilePath | Returns the physical path to the requested URI. (Overrides HttpWorkerRequest.GetFilePath().) |
|
|
GetFilePathTranslated | Returns the physical file path to the requested URI (and translates it from virtual path to physical path: for example, "/proj1/page.aspx" to "c:\dir\page.aspx") (Overrides HttpWorkerRequest.GetFilePathTranslated().) |
|
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
|
GetHttpVerbName | Returns the HTTP request verb. (Overrides HttpWorkerRequest.GetHttpVerbName().) |
|
|
GetHttpVersion | Returns the HTTP version string of the request (for example, "HTTP/1.1"). (Overrides HttpWorkerRequest.GetHttpVersion().) |
|
|
GetKnownRequestHeader | Returns the standard HTTP request header that corresponds to the specified index. (Inherited from HttpWorkerRequest.) |
|
|
GetLocalAddress | Returns the server IP address of the interface on which the request was received. (Overrides HttpWorkerRequest.GetLocalAddress().) |
|
|
GetLocalPort | Returns the port number on which the request was received. (Overrides HttpWorkerRequest.GetLocalPort().) |
|
|
GetPathInfo | Returns additional path information for a resource with a URL extension. That is, for the path /virdir/page.html/tail, the return value is /tail. (Overrides HttpWorkerRequest.GetPathInfo().) |
|
|
GetPreloadedEntityBody() | Returns the portion of the HTTP request body that has already been read. (Inherited from HttpWorkerRequest.) |
|
|
GetPreloadedEntityBody(Byte[], Int32) | Gets the portion of the HTTP request body that has currently been read by using the specified buffer data and byte offset. (Inherited from HttpWorkerRequest.) |
|
|
GetPreloadedEntityBodyLength | Gets the length of the portion of the HTTP request body that has currently been read. (Inherited from HttpWorkerRequest.) |
|
|
GetProtocol | When overridden in a derived class, returns the HTTP protocol (HTTP or HTTPS). (Inherited from HttpWorkerRequest.) |
|
|
GetQueryString | Returns the query string specified in the request URL. (Overrides HttpWorkerRequest.GetQueryString().) |
|
|
GetQueryStringRawBytes | When overridden in a derived class, returns the response query string as an array of bytes. (Inherited from HttpWorkerRequest.) |
|
|
GetRawUrl | Returns the URL path contained in the header with the query string appended. (Overrides HttpWorkerRequest.GetRawUrl().) |
|
|
GetRemoteAddress | Returns the IP address of the client. (Overrides HttpWorkerRequest.GetRemoteAddress().) |
|
|
GetRemoteName | When overridden in a derived class, returns the name of the client computer. (Inherited from HttpWorkerRequest.) |
|
|
GetRemotePort | Returns the client's port number. (Overrides HttpWorkerRequest.GetRemotePort().) |
|
|
GetRequestReason | Infrastructure. When overridden in a derived class, returns the reason for the request. (Inherited from HttpWorkerRequest.) |
|
|
GetServerName | When overridden in a derived class, returns the name of the local server. (Inherited from HttpWorkerRequest.) |
|
|
GetServerVariable | Returns a single server variable from a dictionary of server variables associated with the request. (Overrides HttpWorkerRequest.GetServerVariable(String).) |
|
|
GetTotalEntityBodyLength | Gets the length of the entire HTTP request body. (Inherited from HttpWorkerRequest.) |
|
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
|
GetUnknownRequestHeader | Returns a nonstandard HTTP request header value. (Inherited from HttpWorkerRequest.) |
|
|
GetUnknownRequestHeaders | Get all nonstandard HTTP header name-value pairs. (Inherited from HttpWorkerRequest.) |
|
|
GetUriPath | Returns the virtual path to the requested URI. (Overrides HttpWorkerRequest.GetUriPath().) |
|
|
GetUrlContextID | Infrastructure. When overridden in a derived class, returns the context ID of the current connection. (Inherited from HttpWorkerRequest.) |
|
|
GetUserToken | Returns the client's impersonation token. (Overrides HttpWorkerRequest.GetUserToken().) |
|
|
GetVirtualPathToken | Infrastructure. Gets the impersonation token for the request virtual path. (Inherited from HttpWorkerRequest.) |
|
|
HasEntityBody | Returns a value indicating whether the request contains body data. (Inherited from HttpWorkerRequest.) |
|
|
HeadersSent | Returns a value indicating whether HTTP response headers have been sent to the client for the current request. (Inherited from HttpWorkerRequest.) |
|
|
IsClientConnected | Returns a value indicating whether the client connection is still active. (Inherited from HttpWorkerRequest.) |
|
|
IsEntireEntityBodyIsPreloaded | Returns a value indicating whether all request data is available and no further reads from the client are required. (Inherited from HttpWorkerRequest.) |
|
|
IsSecure | Returns a value indicating whether the connection uses SSL. (Inherited from HttpWorkerRequest.) |
|
|
MapPath | Returns the physical path corresponding to the specified virtual path. (Overrides HttpWorkerRequest.MapPath(String).) |
|
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
|
ReadEntityBody(Byte[], Int32) | Reads request data from the client (when not preloaded). (Inherited from HttpWorkerRequest.) |
|
|
ReadEntityBody(Byte[], Int32, Int32) | Reads request data from the client (when not preloaded) by using the specified buffer to read from, byte offset, and maximum bytes. (Inherited from HttpWorkerRequest.) |
|
|
SendCalculatedContentLength(Int32) | Adds a Content-Length HTTP header to the response for message bodies that are less than or equal to 2 GB. (Inherited from HttpWorkerRequest.) |
|
|
SendCalculatedContentLength(Int64) | Adds a Content-Length HTTP header to the response for message bodies that are greater than 2 GB. (Inherited from HttpWorkerRequest.) |
|
|
SendKnownResponseHeader | Adds a standard HTTP header to the response. (Overrides HttpWorkerRequest.SendKnownResponseHeader(Int32, String).) |
|
|
SendResponseFromFile(IntPtr, Int64, Int64) | Adds the contents of the file with the specified handle to the response and specifies the starting position in the file and the number of bytes to send. (Overrides HttpWorkerRequest.SendResponseFromFile(IntPtr, Int64, Int64).) |
|
|
SendResponseFromFile(String, Int64, Int64) | Adds the contents of the file with the specified name to the response and specifies the starting position in the file and the number of bytes to send. (Overrides HttpWorkerRequest.SendResponseFromFile(String, Int64, Int64).) |
|
|
SendResponseFromMemory(Byte[], Int32) | Adds the contents of a byte array to the response and specifies the number of bytes to send. (Overrides HttpWorkerRequest.SendResponseFromMemory(Byte[], Int32).) |
|
|
SendResponseFromMemory(IntPtr, Int32) | Adds the specified number of bytes from a block of memory to the response. (Inherited from HttpWorkerRequest.) |
|
|
SendStatus | Specifies the HTTP status code and status description of the response; for example, SendStatus(200, "Ok"). (Overrides HttpWorkerRequest.SendStatus(Int32, String).) |
|
|
SendUnknownResponseHeader | Adds a nonstandard HTTP header to the response. (Overrides HttpWorkerRequest.SendUnknownResponseHeader(String, String).) |
|
|
SetEndOfSendNotification | Registers for an optional notification when all the response data is sent. (Inherited from HttpWorkerRequest.) |
|
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
This simple implementation of HttpWorkerRequest provides the request URL and the query string and captures the body of the output into a TextWriter. To achieve richer functionality, such as providing posted content and headers and capturing the response headers or response body as binary data, you should extend SimpleWorkerRequest and override the appropriate HttpWorkerRequest methods.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.
