HttpWorkerRequest 类

定义

命名空间:

System.Web

程序集:

System.Web.dll

此抽象类定义由 ASP.NET 托管代码用于处理请求的基本辅助方法和枚举。

public ref class HttpWorkerRequest abstract

[System.Runtime.InteropServices.ComVisible(false)]
public abstract class HttpWorkerRequest

[<System.Runtime.InteropServices.ComVisible(false)>]
type HttpWorkerRequest = class

Public MustInherit Class HttpWorkerRequest

继承

Object

HttpWorkerRequest

派生

System.Web.Hosting.SimpleWorkerRequest

属性

ComVisibleAttribute

注解

在大多数情况下，代码不会直接处理， HttpWorkerRequest 因为请求和响应数据通过 HttpRequest 和 HttpResponse 类公开。 某些内部 ASP.NET 类扩展此类。 如果代码实现自己的托管环境，则需要扩展此类以调用 ProcessRequest 方法。 此外，代码还可以创建派生类，以便在给定应用程序中执行子请求，以便将其实例传递给 ProcessRequest。 在这种情况下，派生类应保留对当前 HttpWorkerRequest 的引用，并将大部分方法委托给它。

构造函数

HttpWorkerRequest()

初始化 HttpWorkerRequest 类的新实例。

字段

HeaderAccept	指定 AcceptHTTP 标头的索引号。
HeaderAcceptCharset	指定 Accept-CharsetHTTP 标头的索引号。
HeaderAcceptEncoding	指定 Accept-EncodingHTTP 标头的索引号。
HeaderAcceptLanguage	指定 Accept-LanguageHTTP 标头的索引号。
HeaderAcceptRanges	指定 Accept-RangesHTTP 标头的索引号。
HeaderAge	指定 AgeHTTP 标头的索引号。
HeaderAllow	指定 AllowHTTP 标头的索引号。
HeaderAuthorization	指定 AuthorizationHTTP 标头的索引号。
HeaderCacheControl	表示 HTTPCache-ControlHTTP 标头的索引。
HeaderConnection	指定 ConnectionHTTP 标头的索引号。
HeaderContentEncoding	指定 Content-EncodingHTTP 标头的索引号。
HeaderContentLanguage	指定 Content-LanguageHTTP 标头的索引号。
HeaderContentLength	指定 Content-LengthHTTP 标头的索引号。
HeaderContentLocation	指定 Content-LocationHTTP 标头的索引号。
HeaderContentMd5	指定 Content-MD5HTTP 标头的索引号。
HeaderContentRange	指定 Content-RangeHTTP 标头的索引号。
HeaderContentType	指定 Content-TypeHTTP 标头的索引号。
HeaderCookie	指定 CookieHTTP 标头的索引号。
HeaderDate	指定 DateHTTP 标头的索引号。
HeaderEtag	指定 ETagHTTP 标头的索引号。
HeaderExpect	指定 ExceptHTTP 标头的索引号。
HeaderExpires	指定 ExpiresHTTP 标头的索引号。
HeaderFrom	指定 FromHTTP 标头的索引号。
HeaderHost	指定 HostHTTP 标头的索引号。
HeaderIfMatch	指定 If-MatchHTTP 标头的索引号。
HeaderIfModifiedSince	指定 If-Modified-SinceHTTP 标头的索引号。
HeaderIfNoneMatch	指定 If-None-MatchHTTP 标头的索引号。
HeaderIfRange	指定 If-RangeHTTP 标头的索引号。
HeaderIfUnmodifiedSince	指定 If-Unmodified-SinceHTTP 标头的索引号。
HeaderKeepAlive	指定 Keep-AliveHTTP 标头的索引号。
HeaderLastModified	指定 Last-ModifiedHTTP 标头的索引号。
HeaderLocation	指定 LocationHTTP 标头的索引号。
HeaderMaxForwards	指定 Max-ForwardsHTTP 标头的索引号。
HeaderPragma	指定 PragmaHTTP 标头的索引号。
HeaderProxyAuthenticate	指定 Proxy-AuthenticateHTTP 标头的索引号。
HeaderProxyAuthorization	指定 Proxy-AuthorizationHTTP 标头的索引号。
HeaderRange	指定 RangeHTTP 标头的索引号。
HeaderReferer	指定 RefererHTTP 标头的索引号。
HeaderRetryAfter	指定 Retry-AfterHTTP 标头的索引号。
HeaderServer	指定 ServerHTTP 标头的索引号。
HeaderSetCookie	指定 Set-CookieHTTP 标头的索引号。
HeaderTe	指定 TEHTTP 标头的索引号。
HeaderTrailer	指定 TrailerHTTP 标头的索引号。
HeaderTransferEncoding	指定 Transfer-EncodingHTTP 标头的索引号。
HeaderUpgrade	指定 UpgradeHTTP 标头的索引号。
HeaderUserAgent	指定 User-AgentHTTP 标头的索引号。
HeaderVary	指定 VaryHTTP 标头的索引号。
HeaderVia	指定 ViaHTTP 标头的索引号。
HeaderWarning	指定 WarningHTTP 标头的索引号。
HeaderWwwAuthenticate	指定 WWW-AuthenticateHTTP 标头的索引号。
ReasonCachePolicy	指定请求的原因。
ReasonCacheSecurity	指定请求的原因。
ReasonClientDisconnect	指定请求的原因。
ReasonDefault	指定请求的原因。 默认值是 ReasonResponseCacheMiss。
ReasonFileHandleCacheMiss	指定请求的原因。
ReasonResponseCacheMiss	指定请求的原因。
RequestHeaderMaximum	指定 MaximumHTTP 请求标头的索引号。
ResponseHeaderMaximum	指定 MaximumHTTP 响应标头的索引号。

属性

MachineConfigPath	获取 Machine.config 文件的完整物理路径。
MachineInstallDirectory	获取 ASP.NET 二进制文件的安装目录的物理路径。
RequestTraceIdentifier	获取当前请求的 Windows 跟踪 ID 的对应事件跟踪。
RootWebConfigPath	获取根 Web.config 文件的完整物理路径。
SupportsAsyncFlush	获取一个值，该值指示是否支持异步刷新操作。
SupportsAsyncRead	获取一个值，该值指示是否支持异步读取操作。

方法

BeginFlush(AsyncCallback, Object)	向客户端发送当前所有缓冲的响应。
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	启动请求的实体正文中的一次异步读取操作。
CloseConnection()	终止与客户端的连接。
EndFlush(IAsyncResult)	等待挂起的异步刷新操作完成。
EndOfRequest()	由运行时使用以通知 HttpWorkerRequest 当前请求的请求处理已完成。
EndRead(IAsyncResult)	等待挂起的异步读操作完成。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FlushResponse(Boolean)	将所有挂起的响应数据发送到客户端。
GetAppPath()	返回当前正在执行的服务器应用程序的虚拟路径。
GetAppPathTranslated()	返回当前正在执行的服务器应用程序的物理路径。
GetAppPoolID()	在派生类中被重写时，返回当前 URL 的应用程序池 ID。
GetBytesRead()	获取从客户端读入的字节数。
GetClientCertificate()	在派生类中被重写时，从客户端发出的请求获取证书字段（以 X.509 标准指定）。
GetClientCertificateBinaryIssuer()	获取证书颁发者（以二进制格式表示）。
GetClientCertificateEncoding()	在派生类中被重写时，返回用于编码客户端证书的 Encoding 对象。
GetClientCertificatePublicKey()	在派生类中被重写时，获取与客户端证书关联的 PublicKey 对象。
GetClientCertificateValidFrom()	在派生类中被重写时，则获取证书开始生效的日期。 此日期随区域设置的不同而不同。
GetClientCertificateValidUntil()	获取证书到期日期。
GetConnectionID()	在派生类中被重写时，返回当前连接的 ID。
GetFilePath()	在派生类中被重写时，返回所请求的 URI 的虚拟路径。
GetFilePathTranslated()	返回请求的 URI 的物理文件路径（并将其从虚拟路径转换成物理路径：例如，从“/proj1/page.aspx”转换成“c:\dir\page.aspx”）
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetHttpVerbName()	返回请求标头的指定成员。
GetHttpVersion()	提供对请求的 HTTP 版本（如“HTTP/1.1”）的访问。
GetKnownRequestHeader(Int32)	返回与指定的索引相对应的标准 HTTP 请求标头。
GetKnownRequestHeaderIndex(String)	返回指定的 HTTP 请求标头的索引号。
GetKnownRequestHeaderName(Int32)	返回指定的 HTTP 请求标头的名称。
GetKnownResponseHeaderIndex(String)	返回指定的 HTTP 响应标头的索引号。
GetKnownResponseHeaderName(Int32)	返回指定的 HTTP 响应标头的名称。
GetLocalAddress()	提供对请求标头的指定成员的访问。
GetLocalPort()	提供对请求标头的指定成员的访问。
GetPathInfo()	返回具有 URL 扩展的资源的其他路径信息。 即对于路径 /virdir/page.html/tail，GetPathInfo 值为 /tail。
GetPreloadedEntityBody()	返回 HTTP 请求正文已被读取的部分。
GetPreloadedEntityBody(Byte[], Int32)	使用指定的缓冲区数据和字节偏移量获取 HTTP 请求正文当前已被读取的部分。
GetPreloadedEntityBodyLength()	获取 HTTP 请求正文当前已被读取部分的长度。
GetProtocol()	在派生类中被重写时，返回 HTTP 协议（HTTP 或 HTTPS）。
GetQueryString()	返回请求 URL 中指定的查询字符串。
GetQueryStringRawBytes()	在派生类中被重写时，以字节数组的形式返回响应查询字符串。
GetRawUrl()	返回附加了查询字符串的请求标头中包含的 URL 路径。
GetRemoteAddress()	提供对请求标头的指定成员的访问。
GetRemoteName()	在派生类中被重写时，返回客户端计算机的名称。
GetRemotePort()	提供对请求标头的指定成员的访问。
GetRequestReason()	在派生类中被重写时，返回请求的原因。
GetServerName()	在派生类中被重写时，返回本地服务器的名称。
GetServerVariable(String)	从与请求关联的服务器变量词典返回单个服务器变量。
GetStatusDescription(Int32)	返回一个字符串，该字符串描述指定的 HTTP 状态代码的名称。
GetTotalEntityBodyLength()	获取整个 HTTP 请求正文的长度。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetUnknownRequestHeader(String)	返回非标准的 HTTP 请求标头值。
GetUnknownRequestHeaders()	获取所有非标准的 HTTP 标头的名称/值对。
GetUriPath()	返回请求的 URI 的虚拟路径。
GetUrlContextID()	当在派生类中被重写时，返回当前连接的上下文 ID。
GetUserToken()	在派生类中被重写时，返回客户端的模拟标记。
GetVirtualPathToken()	获取请求虚拟路径的模拟标记。
HasEntityBody()	返回一个值，该值指示请求是否包含正文数据。
HeadersSent()	返回一个值，该值指示是否已为当前的请求将 HTTP 响应标头发送到客户端。
IsClientConnected()	返回一个值，该值指示客户端连接是否仍处于活动状态。
IsEntireEntityBodyIsPreloaded()	返回一个值，该值指示是否所有请求数据都可用，以及是否不需要对客户端进行进一步读取。
IsSecure()	返回一个指示连接是否使用 SSL 的值。
MapPath(String)	返回与指定虚拟路径相对应的物理路径。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ReadEntityBody(Byte[], Int32)	读取客户端的请求数据（在尚未预加载时）。
ReadEntityBody(Byte[], Int32, Int32)	使用指定的要从中读取数据的缓冲区、字节偏移量和最大字节数从客户端读取请求数据（当未预先加载时）。
SendCalculatedContentLength(Int32)	将 Content-Length HTTP 标头添加到小于或等于 2 GB 的消息正文的响应。
SendCalculatedContentLength(Int64)	将 Content-Length HTTP 标头添加到大于 2 GB 的消息正文的响应。
SendKnownResponseHeader(Int32, String)	将标准 HTTP 标头添加到响应。
SendResponseFromFile(IntPtr, Int64, Int64)	将指定文件的内容添加到响应并指定文件中的起始位置和要发送的字节数。
SendResponseFromFile(String, Int64, Int64)	将指定文件的内容添加到响应并指定文件中的起始位置和要发送的字节数。
SendResponseFromMemory(Byte[], Int32)	将字节数组中指定数目的字节添加到响应。
SendResponseFromMemory(IntPtr, Int32)	将内存块中指定数目的字节添加到响应。
SendStatus(Int32, String)	指定响应的 HTTP 状态代码和状态说明，例如 SendStatus(200, "Ok")。
SendUnknownResponseHeader(String, String)	将非标准 HTTP 标头添加到响应。
SetEndOfSendNotification(HttpWorkerRequest+EndOfSendNotification, Object)	在发送所有响应数据后注册可选通知。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• ProcessRequest(HttpWorkerRequest)