HttpWorkerRequest 类

定义

此抽象类定义由 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 因为请求和响应数据通过 HttpRequestHttpResponse 类公开。 某些内部 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)

适用于

另请参阅