HttpRequestBase 类

定义

命名空间:

System.Web

程序集:

System.Web.Abstractions.dll

程序集:

System.Web.dll

用作一些类的基类，这些类使 ASP.NET 可以读取客户端在 Web 请求过程中发送的 HTTP 值。

public ref class HttpRequestBase abstract

public abstract class HttpRequestBase

type HttpRequestBase = class

Public MustInherit Class HttpRequestBase

继承

Object

HttpRequestBase

派生

System.Web.HttpRequestWrapper

注解

类 HttpRequestBase 是一个抽象类，其中包含与 类相同的 HttpRequest 成员。 使用 类可以创建类似 类的派生类，但可以自定义和在管道 ASP.NET HttpRequestBase HttpRequest 类。 执行单元测试时，通常使用派生类来实现具有满足所测试方案的自定义行为的成员。

HttpRequestWrapper 类是从 HttpRequestBase 类派生的。 HttpRequestWrapper类充当 类的 HttpRequest 包装器。 运行时，通常使用 类的实例 HttpRequestWrapper 来调用 对象 HttpRequest 的成员。

构造函数

HttpRequestBase()

初始化该类供继承的类实例使用。 此构造函数只能由继承的类调用。

属性

AcceptTypes	在派生类中替代时，获取客户端支持的 MIME 接受类型的数组。
AnonymousID	在派生类中替代时，获取用户的匿名标识符(如果存在)。
ApplicationPath	在派生类中替代时，获取服务器上的 ASP.NET 应用程序的虚拟根路径。
AppRelativeCurrentExecutionFilePath	在派生类中替代时，获取应用程序根目录的虚拟路径，并通过对应用程序根目录使用波形符 (~) 表示法（例如，以“~/page.aspx”的形式）使该路径成为相对路径。
Browser	在派生类中替代时，获取有关请求客户端的浏览器功能的信息。
ClientCertificate	在派生类中替代时，获取当前请求的客户端安全证书。
ContentEncoding	在派生类中替代时，获取或设置客户端提供的数据的字符集。
ContentLength	在派生类中替代时，获取客户端发送的内容的长度(以字节为单位)。
ContentType	在派生类中替代时，获取或设置请求的 MIME 内容类型。
Cookies	在派生类中替代时，获取客户端发送的 cookie 的集合。
CurrentExecutionFilePath	在派生类中替代时，获取当前请求的虚拟路径。
CurrentExecutionFilePathExtension	在派生类中实现时，获取在 CurrentExecutionFilePath 属性中指定的文件名扩展名。
FilePath	在派生类中替代时，获取当前请求的虚拟路径。
Files	在派生类中替代时，获取客户端上载的文件的集合(多部分 MIME 格式)。
Filter	在派生类中替代时，获取或设置要在读取当前输入流时使用的筛选器。
Form	在派生类中替代时，获取客户端发送的窗体变量的集合。
Headers	在派生类中替代时，获取客户端发送的 HTTP 标头的集合。
HttpChannelBinding	在派生类中替代时，获取当前 ChannelBinding 实例的 HttpWorkerRequest 对象。
HttpMethod	在派生类中替代时，获取客户端使用的 HTTP 数据传输方法(如 GET、POST 或 HEAD)。
InputStream	在派生类中替代时，获取传入的 HTTP 实体主体的内容。
IsAuthenticated	在派生类中替代时，获取指示请求是否已经过身份验证的值。
IsLocal	在派生类中替代时，获取指示请求是否来自本地计算机的值。
IsSecureConnection	在派生类中替代时，获取指示 HTTP 连接是否使用安全套接字(HTTPS 协议)的值。
Item[String]	在派生类中替代时，从 Cookies、Form、QueryString 或 ServerVariables 集合获取指定的对象。
LogonUserIdentity	在派生类中重写时，获取当前用户的 WindowsIdentity 类型。
Params	在派生类中替代时，获取 QueryString、Form、ServerVariables 和 Cookies 项的组合集合。
Path	在派生类中替代时，获取当前请求的虚拟路径。
PathInfo	在派生类中替代时，获取具有 URL 扩展名的资源的附加路径信息。
PhysicalApplicationPath	在派生类中替代时，获取当前应用程序的根目录的物理文件系统路径。
PhysicalPath	在派生类中替代时，获取请求的资源的物理文件系统路径。
QueryString	在派生类中替代时，获取 HTTP 查询字符串变量的集合。
RawUrl	在派生类中替代时，获取当前请求的完整 URL。
ReadEntityBodyMode	在派生类中实现时，获取一个值，该值指示是否已读取请求实体主体，若已读取，是以何方式读取。
RequestContext	在派生类中替代时，获取当前请求的 RequestContext 实例。
RequestType	在派生类中替代时，获取或设置客户端使用的 HTTP 数据传输方法(GET 或 POST)。
ServerVariables	在派生类中替代时，获取 Web 服务器变量的集合。
TimedOutToken	在派生类中实现时，当请求超时时获取去除的 CancellationToken 对象。
TlsTokenBindingInfo	获取或设置此实例的标记绑定信息。
TotalBytes	在派生类中替代时，获取当前输入流中的字节数。
Unvalidated	在派生类中实现时，提供对 HTTP 请求值的访问权(在不触发请求验证的情况下)。
Url	在派生类中替代时，获取有关当前请求的 URL 的信息。
UrlReferrer	在派生类中替代时，获取有关链接到当前 URL 的客户端请求的 URL 的信息。
UserAgent	在派生类中替代时，获取客户端的完整用户代理字符串。
UserHostAddress	在派生类中替代时，获取客户端的 IP 主机地址。
UserHostName	在派生类中替代时，获取客户端的 DNS 名称。
UserLanguages	在派生类中替代时，获取客户端语言首选项的已排序数组。

方法

Abort()	强制地终止基础 TCP 连接，会导致任何显著的 I/O 失败。
BinaryRead(Int32)	在派生类中替代时，对当前输入流执行指定字节数的二进制读取。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetBufferedInputStream()	在派生类中实现时，获取一个 Stream 对象，它可用于读取传入 HTTP 实体主体。
GetBufferlessInputStream()	在派生类中实现时，获取可用于读取传入 HTTP 实体主体的 Stream 对象，从而可选择性地禁用在 MaxRequestLength 属性中设置的请求长度限制。
GetBufferlessInputStream(Boolean)	在派生类中实现时，获取可用于读取传入 HTTP 实体主体的 Stream 对象，从而可选择性地禁用在 MaxRequestLength 属性中设置的请求长度限制。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
InsertEntityBody()	在派生类中实现时，向 IIS 提供 HTTP 请求实体主体的副本。
InsertEntityBody(Byte[], Int32, Int32)	在派生类中实现时，向 IIS 提供 HTTP 请求实体主体的副本以及有关请求实体对象的信息。
MapImageCoordinates(String)	在派生类中替代时，将传入的图像字段窗体参数映射到合适的 x 坐标和 y 坐标值。
MapPath(String)	在派生类中替代时，将指定的虚拟路径映射到服务器上的物理路径。
MapPath(String, String, Boolean)	在派生类中替代时，将指定的虚拟路径映射到服务器上的物理路径。
MapRawImageCoordinates(String)	将传入图像字段窗体参数映射为适当的 x 和 y 坐标值。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SaveAs(String, Boolean)	在派生类中替代时，将 HTTP 请求保存到磁盘。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
ValidateInput()	在派生类中替代时，引发对通过 Cookies、Form 和 QueryString 属性访问的集合的验证。