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 屬性存取的集合進行驗證。 |