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

指定 HTTP 标头的 Accept 索引号。

HeaderAcceptCharset

指定 HTTP 标头的 Accept-Charset 索引号。

HeaderAcceptEncoding

指定 HTTP 标头的 Accept-Encoding 索引号。

HeaderAcceptLanguage

指定 HTTP 标头的 Accept-Language 索引号。

HeaderAcceptRanges

指定 HTTP 标头的 Accept-Ranges 索引号。

HeaderAge

指定 HTTP 标头的 Age 索引号。

HeaderAllow

指定 HTTP 标头的 Allow 索引号。

HeaderAuthorization

指定 HTTP 标头的 Authorization 索引号。

HeaderCacheControl

表示 HTTP Cache-Control HTTP 标头的索引。

HeaderConnection

指定 HTTP 标头的 Connection 索引号。

HeaderContentEncoding

指定 HTTP 标头的 Content-Encoding 索引号。

HeaderContentLanguage

指定 HTTP 标头的 Content-Language 索引号。

HeaderContentLength

指定 HTTP 标头的 Content-Length 索引号。

HeaderContentLocation

指定 HTTP 标头的 Content-Location 索引号。

HeaderContentMd5

指定 HTTP 标头的 Content-MD5 索引号。

HeaderContentRange

指定 HTTP 标头的 Content-Range 索引号。

HeaderContentType

指定 HTTP 标头的 Content-Type 索引号。

HeaderCookie

指定 HTTP 标头的 Cookie 索引号。

HeaderDate

指定 HTTP 标头的 Date 索引号。

HeaderEtag

指定 HTTP 标头的 ETag 索引号。

HeaderExpect

指定 HTTP 标头的 Except 索引号。

HeaderExpires

指定 HTTP 标头的 Expires 索引号。

HeaderFrom

指定 HTTP 标头的 From 索引号。

HeaderHost

指定 HTTP 标头的 Host 索引号。

HeaderIfMatch

指定 HTTP 标头的 If-Match 索引号。

HeaderIfModifiedSince

指定 HTTP 标头的 If-Modified-Since 索引号。

HeaderIfNoneMatch

指定 HTTP 标头的 If-None-Match 索引号。

HeaderIfRange

指定 HTTP 标头的 If-Range 索引号。

HeaderIfUnmodifiedSince

指定 HTTP 标头的 If-Unmodified-Since 索引号。

HeaderKeepAlive

指定 HTTP 标头的 Keep-Alive 索引号。

HeaderLastModified

指定 HTTP 标头的 Last-Modified 索引号。

HeaderLocation

指定 HTTP 标头的 Location 索引号。

HeaderMaxForwards

指定 HTTP 标头的 Max-Forwards 索引号。

HeaderPragma

指定 HTTP 标头的 Pragma 索引号。

HeaderProxyAuthenticate

指定 HTTP 标头的 Proxy-Authenticate 索引号。

HeaderProxyAuthorization

指定 HTTP 标头的 Proxy-Authorization 索引号。

HeaderRange

指定 HTTP 标头的 Range 索引号。

HeaderReferer

指定 HTTP 标头的 Referer 索引号。

HeaderRetryAfter

指定 HTTP 标头的 Retry-After 索引号。

HeaderServer

指定 HTTP 标头的 Server 索引号。

HeaderSetCookie

指定 HTTP 标头的 Set-Cookie 索引号。

HeaderTe

指定 HTTP 标头的 TE 索引号。

HeaderTrailer

指定 HTTP 标头的 Trailer 索引号。

HeaderTransferEncoding

指定 HTTP 标头的 Transfer-Encoding 索引号。

HeaderUpgrade

指定 HTTP 标头的 Upgrade 索引号。

HeaderUserAgent

指定 HTTP 标头的 User-Agent 索引号。

HeaderVary

指定 HTTP 标头的 Vary 索引号。

HeaderVia

指定 HTTP 标头的 Via 索引号。

HeaderWarning

指定 HTTP 标头的 Warning 索引号。

HeaderWwwAuthenticate

指定 HTTP 标头的 WWW-Authenticate 索引号。

ReasonCachePolicy

指定请求的原因。

ReasonCacheSecurity

指定请求的原因。

ReasonClientDisconnect

指定请求的原因。

ReasonDefault

指定请求的原因。 默认值为 ReasonResponseCacheMiss

ReasonFileHandleCacheMiss

指定请求的原因。

ReasonResponseCacheMiss

指定请求的原因。

RequestHeaderMaximum

指定 HTTP 请求标头的 Maximum 索引号。

ResponseHeaderMaximum

指定 HTTP 响应标头的 Maximum 索引号。

属性

名称 说明
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, Int32)

通过使用指定的缓冲区从客户端读取请求数据(未预加载时),读取字节偏移量和最大字节数。

ReadEntityBody(Byte[], Int32)

从客户端读取请求数据(未预加载时)。

SendCalculatedContentLength(Int32)

Content-Length为小于或等于 2 GB 的消息正文的响应添加 HTTP 标头。

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)

适用于

另请参阅