HttpRequestBase 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

作為類別的基底類別，使 ASP.NET 能讀取用戶端在網路請求中所傳送的 HTTP 值。

public ref class HttpRequestBase abstract

public abstract class HttpRequestBase

type HttpRequestBase = class

Public MustInherit Class HttpRequestBase

繼承

Object

HttpRequestBase

衍生

System.Web.HttpRequestWrapper

備註

該 HttpRequestBase 類別是一個抽象類別，包含與該 HttpRequest 類別相同的成員。 HttpRequestBase 類別讓你可以建立類似 HttpRequest 類別的衍生類別，但你可以自訂，且能在 ASP.NET 管線之外運作。 當你執行單元測試時，通常會使用導出類別來實作具有自訂行為、符合你測試情境的成員。

類別 HttpRequestWrapper 衍生自 HttpRequestBase 類別。 這個HttpRequestWrapper類別作為該類別的包裝。HttpRequest 執行時，通常會使用類別的 HttpRequestWrapper 實例來呼叫物件 HttpRequest 的成員。

建構函式

名稱	Description
HttpRequestBase()	初始化該類別以供繼承類別實例使用。 這個建構函式只能由繼承的類別呼叫。

屬性

名稱	Description
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]	當在派生類別中被覆寫時，會從 、 Form、 QueryString或ServerVariables集合中取得指定的物件Cookies。
LogonUserIdentity	當在衍生類別中被覆寫時，會獲得 WindowsIdentity 當前使用者的型別。
Params	當在衍生類別中覆寫時，會得到一個結合的集合，包括 QueryString、 Form、 ServerVariablesCookies 和 項目。
Path	當在衍生類別中覆寫時，會取得目前請求的虛擬路徑。
PathInfo	當在衍生類別中覆寫時，會獲得具有 URL 副檔名的資源的額外路徑資訊。
PhysicalApplicationPath	當在衍生類別中被覆寫時，會取得目前應用程式根目錄的實體檔案系統路徑。
PhysicalPath	當在衍生類別中覆寫時，會取得所請求資源的實體檔案系統路徑。
QueryString	當在衍生類別中覆寫時，會取得 HTTP 查詢字串變數的集合。
RawUrl	當在衍生類別中覆寫時，會取得目前請求的完整 URL。
ReadEntityBodyMode	當在衍生類別中實作時，會獲得一個值，表示請求實體實體是否已被讀取，若有，則是如何被讀取。
RequestContext	當在衍生類別中覆寫時，會取得 RequestContext 目前請求的實例。
RequestType	當在派生類別中被覆寫時，會取得或設定用戶端所使用的 HTTP 資料傳輸方法（GETPOST或 ）。
ServerVariables	當在派生類別中被覆寫時，會獲得一組網頁伺服器變數。
TimedOutToken	當在衍生類別實作時，會得到 CancellationToken 一個物件，當請求逾時時會觸發這個物件。
TlsTokenBindingInfo	取得或設定此實例的令牌綁定資訊。
TotalBytes	當在派生類別中覆寫時，會得到目前輸入串流中的位元組數。
Unvalidated	當以衍生類別實作時，提供存取 HTTP 請求值且不觸發請求驗證。
Url	當在衍生類別中覆寫時，會獲得目前請求的 URL 資訊。
UrlReferrer	當在衍生類別中覆寫時，會獲得連結到當前 URL 的客戶端請求的 URL 資訊。
UserAgent	當在衍生類別中覆寫時，會得到客戶端完整的用戶代理字串。
UserHostAddress	當在衍生類別中被覆寫時，會取得用戶端的 IP 主機位址。
UserHostName	當在衍生類別中被覆寫時，會取得用戶端的 DNS 名稱。
UserLanguages	當在衍生類別中覆寫時，會獲得一個排序好的客戶端語言偏好陣列。

方法

名稱	Description
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()	當在衍生類別中覆寫時，會對透過 Cookies、 Form及 QueryString 屬性存取的集合進行驗證。