HttpRequestWrapper 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
封裝了 HTTP 內在物件，使 ASP.NET 能夠讀取用戶端在網頁請求中傳送的 HTTP 值。
public ref class HttpRequestWrapper : System::Web::HttpRequestBasepublic class HttpRequestWrapper : System.Web.HttpRequestBasetype HttpRequestWrapper = class
inherit HttpRequestBasePublic Class HttpRequestWrapper
Inherits HttpRequestBase- 繼承
備註
該 HttpRequestWrapper 類別源自該 HttpRequestBase 類別，並作為該類別的包裝器 HttpRequest 。 這個類別會揭露該HttpRequest類別的功能並揭露型別。HttpRequestBase HttpRequestBase 類別讓你能用自訂實作取代應用程式中的原始 HttpRequest 類別實作，例如在 ASP.NET 管線外進行單元測試時。
建構函式
| 名稱 | Description |
|---|---|
| HttpRequestWrapper(HttpRequest) |
透過使用指定的請求物件初始化該類別的新實例 HttpRequestWrapper 。 |
屬性
| 名稱 | 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 資料傳輸方法（例如 |
| 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 |
取得目前請求的完整網址。 |
| ReadEntityBodyMode |
會得到一個值，表示請求實體實體是否已被讀取，如果有，則是如何被讀取的。 |
| RequestContext |
取得 RequestContext 目前請求的實例。 |
| RequestType |
取得或設定用戶端所使用的 HTTP 資料傳輸方法（ |
| ServerVariables |
會得到一組網頁伺服器變數。 |
| TimedOutToken |
當請求逾時時，會觸發 CancellationToken 一個物件。 |
| TlsTokenBindingInfo |
取得 TLS 代幣綁定資訊。 |
| TotalBytes |
取得目前輸入串流中的位元組數。 |
| Unvalidated |
能存取 HTTP 請求值而不觸發請求驗證。 |
| 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 實體實體的物件。 |
| 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進行驗證。 |
