HttpRequestBase 類別

定義

命名空間:

System.Web

組件:

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 。 類別 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、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()	強制終止造成任何待處理 I/O 失敗的基礎 TCP 連線。
BinaryRead(Int32)	在衍生類別中覆寫時，執行目前輸入資料流中指定位元組數目的二進位讀取。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBufferedInputStream()	在衍生類別中實作時，取得 Stream 物件，這個物件可用來讀取傳入 HTTP 實體內容。
GetBufferlessInputStream()	在衍生類別中實作時，取得 Stream 物件，這個物件可用來讀取傳入 HTTP 實體內容，並選擇性地停用 MaxRequestLength 屬性中所設定的要求長度限制。
GetBufferlessInputStream(Boolean)	在衍生類別中實作時，取得 Stream 物件，這個物件可用來讀取傳入 HTTP 實體內容，並選擇性地停用 MaxRequestLength 屬性中所設定的要求長度限制。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InsertEntityBody()	在衍生類別中實作時，將 HTTP 要求實體內容的複本提供給 IIS。
InsertEntityBody(Byte[], Int32, Int32)	在衍生類別中實作時，將 HTTP 要求實體內容的複本及該要求實體物件的相關資訊提供給 IIS。
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 屬性存取的集合進行驗證。