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
派生

注解

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

该 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、FormQueryString或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()

在派生类中实现时，获取 Stream 可用于读取传入 HTTP 实体正文的对象，可以选择禁用属性中 MaxRequestLength 设置的请求长度限制。
GetBufferlessInputStream(Boolean)

在派生类中实现时，获取 Stream 可用于读取传入 HTTP 实体正文的对象，可以选择禁用属性中 MaxRequestLength 设置的请求长度限制。
GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
InsertEntityBody()

在派生类中实现时，向 IIS 提供 HTTP 请求实体正文的副本。
InsertEntityBody(Byte[], Int32, Int32)

在派生类中实现时，向 IIS 提供 HTTP 请求实体正文的副本以及有关请求实体对象的信息。
MapImageCoordinates(String)

在派生类中重写时，将传入的图像字段表单参数映射到相应的 x 坐标和 y 坐标值。
MapPath(String, String, Boolean)

在派生类中重写时，将指定的虚拟路径映射到服务器上的物理路径。
MapPath(String)

在派生类中重写时，将指定的虚拟路径映射到服务器上的物理路径。
MapRawImageCoordinates(String)

将传入图像字段窗体参数映射到相应的 x 和 y 坐标值。
MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
SaveAs(String, Boolean)

在派生类中重写时，将 HTTP 请求保存到磁盘。
ToString()

返回一个表示当前对象的字符串。

(继承自 Object)
ValidateInput()

在派生类中重写时，会导致对通过 <a0/> 和属性访问的集合进行验证。

适用于