Share via


HttpRequestBase 類別

定義

做為類別的基底類別,這些類別可讓 ASP.NET 讀取用戶端在 Web 要求期間傳送的 HTTP 值。

public ref class HttpRequestBase abstract
public abstract class HttpRequestBase
type HttpRequestBase = class
Public MustInherit Class HttpRequestBase
繼承
HttpRequestBase
衍生

備註

類別 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 資料傳輸方法 (例如 GETPOSTHEAD)。

InputStream

在衍生類別中覆寫時,取得傳入 HTTP 實體內容的內容。

IsAuthenticated

在衍生類別中覆寫時,取得值,這個值表示是否已驗證要求。

IsLocal

在衍生類別中覆寫時,取得值,這個值表示要求是否來自本機電腦。

IsSecureConnection

在衍生類別中覆寫時,取得值,這個值表示 HTTP 連接是否使用安全通訊端 (HTTPS 通訊協定)。

Item[String]

在衍生類別中覆寫時,從 CookiesFormQueryStringServerVariables 集合取得指定的物件。

LogonUserIdentity

在衍生類別中覆寫時,取得目前使用者的 WindowsIdentity 類型。

Params

在衍生類別中覆寫時,取得 QueryStringFormServerVariablesCookies 項目的組合集合。

Path

在衍生類別中覆寫時,取得目前要求的虛擬路徑。

PathInfo

在衍生類別中覆寫時,取得具有 URL 副檔名之資源的其他路徑資訊。

PhysicalApplicationPath

在衍生類別中覆寫時,取得目前應用程式根目錄的實體檔案系統路徑。

PhysicalPath

在衍生類別中覆寫時,取得要求之資源的實體檔案系統路徑。

QueryString

在衍生類別中覆寫時,取得 HTTP 查詢字串變數的集合。

RawUrl

在衍生類別中覆寫時,取得目前要求的完整 URL。

ReadEntityBodyMode

在衍生類別中實作時,取得值,這個值表示是否已讀取要求實體內容及其讀取方式 (如果已讀取的話)。

RequestContext

在衍生類別中覆寫時,取得目前要求的 RequestContext 執行個體。

RequestType

在衍生類別中覆寫時,取得或設定用戶端使用的 HTTP 資料傳輸方法 (GETPOST)。

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()

在衍生類別中覆寫時,會對透過 CookiesFormQueryString 屬性存取的集合進行驗證。

適用於