HttpRequestWrapper 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
封裝 HTTP 內建物件,此物件可讓 ASP.NET 讀取用戶端在 Web 要求期間傳送的 HTTP 值。
public ref class HttpRequestWrapper : System::Web::HttpRequestBase
public class HttpRequestWrapper : System.Web.HttpRequestBase
type HttpRequestWrapper = class
inherit HttpRequestBase
Public Class HttpRequestWrapper
Inherits HttpRequestBase
- 繼承
備註
HttpRequestWrapper類別衍生自 HttpRequestBase 類別,並作為類別的包裝函式 HttpRequest 。 這個類別會公開類別的功能 HttpRequest 並公開型別 HttpRequestBase 。 HttpRequestBase類別可讓您 HttpRequest 在應用程式中使用自訂的實作為來取代類別的原始實作為,例如,當您在 ASP.NET 管線外部執行單元測試時。
建構函式
| HttpRequestWrapper(HttpRequest) |
使用指定的要求物件來初始化 HttpRequestWrapper 類別的新執行個體。 |
屬性
| AcceptTypes |
取得用戶端支援的 MIME 接受 (Accept) 類型的陣列。 |
| AnonymousID |
取得使用者的匿名識別項 (如果有的話)。 |
| ApplicationPath |
取得伺服器上 ASP.NET 應用程式的根虛擬路徑。 |
| AppRelativeCurrentExecutionFilePath |
取得應用程式根目錄的虛擬路徑,並對應用程式根目錄使用波狀符號 (~) 標記法,讓此路徑變成相對路徑 (就像是 "~/page.aspx")。 |
| Browser |
取得要求用戶端之瀏覽器功能的相關資訊。 |
| ClientCertificate |
取得目前要求的用戶端安全憑證。 |
| ContentEncoding |
取得或設定用戶端所提供資料的字元集。 |
| ContentLength |
取得用戶端送出的內容長度,以位元組為單位。 |
| ContentType |
取得或設定要求的 MIME 內容類型。 |
| Cookies |
取得用戶端傳送的 Cookie 集合。 |
| CurrentExecutionFilePath |
取得目前要求的虛擬路徑。 |
| CurrentExecutionFilePathExtension |
取得 CurrentExecutionFilePath 屬性中指定之檔案名稱的副檔名。 |
| CurrentExecutionFilePathExtension |
在衍生類別中實作時,取得 CurrentExecutionFilePath 屬性所指定之檔案名稱的副檔名。 (繼承來源 HttpRequestBase) |
| FilePath |
取得目前要求的虛擬路徑。 |
| Files |
取得用戶端上傳的檔案集合,其格式為多重 MIME。 |
| Filter |
取得或設定讀取目前輸入資料流時使用的篩選條件。 |
| Form |
取得用戶端傳送的表單變數集合。 |
| Headers |
取得用戶端傳送的 HTTP 標頭集合。 |
| HttpChannelBinding |
取得目前 ChannelBinding 執行個體的 HttpWorkerRequest 物件。 |
| HttpChannelBinding |
在衍生類別中覆寫時,取得目前 ChannelBinding 執行個體的 HttpWorkerRequest 物件。 (繼承來源 HttpRequestBase) |
| 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 |
取得目前要求的完整 URL。 |
| ReadEntityBodyMode |
取得值,指出是否已讀取要求實體主體,而且如果是,如何讀取。 |
| ReadEntityBodyMode |
在衍生類別中實作時,取得值,這個值表示是否已讀取要求實體內容及其讀取方式 (如果已讀取的話)。 (繼承來源 HttpRequestBase) |
| RequestContext |
取得目前要求的 RequestContext 執行個體。 |
| RequestContext |
在衍生類別中覆寫時,取得目前要求的 RequestContext 執行個體。 (繼承來源 HttpRequestBase) |
| RequestType |
取得或設定用戶端使用的 HTTP 資料傳輸方法 ( |
| ServerVariables |
取得 Web 伺服器變數的集合。 |
| TimedOutToken |
取得要求逾時所觸發的 CancellationToken 物件。 |
| TimedOutToken |
在衍生類別中實作時,取得要求逾時所觸發的 CancellationToken 物件。 (繼承來源 HttpRequestBase) |
| TlsTokenBindingInfo |
取得 TLS 權杖繫結資訊。 |
| TlsTokenBindingInfo |
取得或設定此執行個體的權杖繫結資訊。 (繼承來源 HttpRequestBase) |
| TotalBytes |
取得目前輸入資料流的位元組數目。 |
| Unvalidated |
提供 HTTP 要求值的存取,而不觸發要求驗證。 |
| Unvalidated |
在衍生類別中實作時,提供對 HTTP 要求值的存取,而不觸發要求驗證。 (繼承來源 HttpRequestBase) |
| Url |
取得關於目前要求的 URL 資訊。 |
| UrlReferrer |
取得連結至目前 URL 之用戶端要求的 URL 相關資訊。 |
| UserAgent |
取得用戶端的完整使用者代理字串。 |
| UserHostAddress |
取得用戶端的 IP 主機位址。 |
| UserHostName |
取得用戶端的 DNS 名稱。 |
| UserLanguages |
取得用戶端語言喜好設定的陣列 (已經過排序)。 |
方法
| Abort() |
強制終止造成任何待處理 I/O 失敗的基礎 TCP 連線。 |
| Abort() |
強制終止造成任何待處理 I/O 失敗的基礎 TCP 連線。 (繼承來源 HttpRequestBase) |
| BinaryRead(Int32) |
在目前輸入資料流執行指定位元組數的二進位讀取。 |
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetBufferedInputStream() |
取得可用來讀取傳入 HTTP 實體內容的 Stream 物件。 |
| GetBufferedInputStream() |
在衍生類別中實作時,取得 Stream 物件,這個物件可用來讀取傳入 HTTP 實體內容。 (繼承來源 HttpRequestBase) |
| GetBufferlessInputStream() |
取得可用來讀取傳入 HTTP 實體內容的 Stream 物件。 |
| GetBufferlessInputStream() |
在衍生類別中實作時,取得 Stream 物件,這個物件可用來讀取傳入 HTTP 實體內容,並選擇性地停用 MaxRequestLength 屬性中所設定的要求長度限制。 (繼承來源 HttpRequestBase) |
| GetBufferlessInputStream(Boolean) |
取得 Stream 物件,這個物件可用來讀取傳入 HTTP 實體內容,並選擇性地停用 MaxRequestLength 屬性中所設定的要求長度限制。 |
| GetBufferlessInputStream(Boolean) |
在衍生類別中實作時,取得 Stream 物件,這個物件可用來讀取傳入 HTTP 實體內容,並選擇性地停用 MaxRequestLength 屬性中所設定的要求長度限制。 (繼承來源 HttpRequestBase) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| InsertEntityBody() |
將 HTTP 要求實體內文的複本提供給 IIS。 |
| InsertEntityBody() |
在衍生類別中實作時,將 HTTP 要求實體內容的複本提供給 IIS。 (繼承來源 HttpRequestBase) |
| InsertEntityBody(Byte[], Int32, Int32) |
將 HTTP 要求實體本文的複本及該要求實體物件的相關資訊提供給 IIS。 |
| InsertEntityBody(Byte[], Int32, Int32) |
在衍生類別中實作時,將 HTTP 要求實體內容的複本及該要求實體物件的相關資訊提供給 IIS。 (繼承來源 HttpRequestBase) |
| MapImageCoordinates(String) |
將收到的影像欄的表單參數對應至適當的 X 座標和 Y 座標值。 |
| MapPath(String) |
將指定的虛擬路徑對應至伺服器上的實體路徑。 |
| MapPath(String, String, Boolean) |
將指定的虛擬路徑對應至伺服器上的實體路徑。 |
| MapRawImageCoordinates(String) |
將收到的影像欄的表單參數對應至適當的 X 和 Y 座標值。 |
| MapRawImageCoordinates(String) |
將收到的影像欄的表單參數對應至適當的 X 和 Y 座標值。 (繼承來源 HttpRequestBase) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| SaveAs(String, Boolean) |
將 HTTP 要求儲存至磁碟。 |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
| ValidateInput() |
會對透過 Cookies、Form 和 QueryString 屬性存取的集合進行驗證。 |