HttpWorkerRequest 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此抽象类定义由 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
- 继承
-
HttpWorkerRequest
- 派生
- 属性
注解
在大多数情况下,代码不会直接处理, HttpWorkerRequest 因为请求和响应数据通过 HttpRequest 和 HttpResponse 类公开。 某些内部 ASP.NET 类扩展此类。 如果代码实现自己的托管环境,则需要扩展此类以调用 ProcessRequest 方法。 此外,代码还可以创建派生类,以便在给定应用程序中执行子请求,以便将其实例传递给 ProcessRequest。 在这种情况下,派生类应保留对当前 HttpWorkerRequest 的引用,并将大部分方法委托给它。
构造函数
| HttpWorkerRequest() |
初始化 HttpWorkerRequest 类的新实例。 |
字段
| HeaderAccept |
指定 |
| HeaderAcceptCharset |
指定 |
| HeaderAcceptEncoding |
指定 |
| HeaderAcceptLanguage |
指定 |
| HeaderAcceptRanges |
指定 |
| HeaderAge |
指定 |
| HeaderAllow |
指定 |
| HeaderAuthorization |
指定 |
| HeaderCacheControl |
表示 HTTP |
| HeaderConnection |
指定 |
| HeaderContentEncoding |
指定 |
| HeaderContentLanguage |
指定 |
| HeaderContentLength |
指定 |
| HeaderContentLocation |
指定 |
| HeaderContentMd5 |
指定 |
| HeaderContentRange |
指定 |
| HeaderContentType |
指定 |
| HeaderCookie |
指定 |
| HeaderDate |
指定 |
| HeaderEtag |
指定 |
| HeaderExpect |
指定 |
| HeaderExpires |
指定 |
| HeaderFrom |
指定 |
| HeaderHost |
指定 |
| HeaderIfMatch |
指定 |
| HeaderIfModifiedSince |
指定 |
| HeaderIfNoneMatch |
指定 |
| HeaderIfRange |
指定 |
| HeaderIfUnmodifiedSince |
指定 |
| HeaderKeepAlive |
指定 |
| HeaderLastModified |
指定 |
| HeaderLocation |
指定 |
| HeaderMaxForwards |
指定 |
| HeaderPragma |
指定 |
| HeaderProxyAuthenticate |
指定 |
| HeaderProxyAuthorization |
指定 |
| HeaderRange |
指定 |
| HeaderReferer |
指定 |
| HeaderRetryAfter |
指定 |
| HeaderServer |
指定 |
| HeaderSetCookie |
指定 |
| HeaderTe |
指定 |
| HeaderTrailer |
指定 |
| HeaderTransferEncoding |
指定 |
| HeaderUpgrade |
指定 |
| HeaderUserAgent |
指定 |
| HeaderVary |
指定 |
| HeaderVia |
指定 |
| HeaderWarning |
指定 |
| HeaderWwwAuthenticate |
指定 |
| ReasonCachePolicy |
指定请求的原因。 |
| ReasonCacheSecurity |
指定请求的原因。 |
| ReasonClientDisconnect |
指定请求的原因。 |
| ReasonDefault |
指定请求的原因。 默认值是 ReasonResponseCacheMiss。 |
| ReasonFileHandleCacheMiss |
指定请求的原因。 |
| ReasonResponseCacheMiss |
指定请求的原因。 |
| RequestHeaderMaximum |
指定 |
| ResponseHeaderMaximum |
指定 |
属性
| 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() |
在派生类中被重写时,获取与客户端证书关联的 |
| 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, |
| 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) |
将 |
| SendCalculatedContentLength(Int64) |
将 |
| SendKnownResponseHeader(Int32, String) |
将标准 HTTP 标头添加到响应。 |
| SendResponseFromFile(IntPtr, Int64, Int64) |
将指定文件的内容添加到响应并指定文件中的起始位置和要发送的字节数。 |
| SendResponseFromFile(String, Int64, Int64) |
将指定文件的内容添加到响应并指定文件中的起始位置和要发送的字节数。 |
| SendResponseFromMemory(Byte[], Int32) |
将字节数组中指定数目的字节添加到响应。 |
| SendResponseFromMemory(IntPtr, Int32) |
将内存块中指定数目的字节添加到响应。 |
| SendStatus(Int32, String) |
指定响应的 HTTP 状态代码和状态说明,例如 |
| SendUnknownResponseHeader(String, String) |
将非标准 HTTP 标头添加到响应。 |
| SetEndOfSendNotification(HttpWorkerRequest+EndOfSendNotification, Object) |
在发送所有响应数据后注册可选通知。 |
| ToString() |
返回表示当前对象的字符串。 (继承自 Object) |