HttpContextBase 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

作為包含特定 HTTP 資訊的類別的基底類別。

public ref class HttpContextBase abstract : IServiceProvider

public abstract class HttpContextBase : IServiceProvider

type HttpContextBase = class
    interface IServiceProvider

Public MustInherit Class HttpContextBase
Implements IServiceProvider

繼承

Object

HttpContextBase

衍生

System.Web.HttpContextWrapper

實作

IServiceProvider

備註

該 HttpContextBase 類別是一個抽象類別，包含與該 HttpContext 類別相同的成員。 HttpContextBase 類別讓你可以建立類似 HttpContext 類別的衍生類別，但你可以自訂，且能在 ASP.NET 管線之外運作。 當你執行單元測試時，通常會使用衍生類別來實作具有自訂行為的成員，以符合你測試的情境。

類別 HttpContextWrapper 衍生自 HttpContextBase 類別。 這個HttpContextWrapper類別作為該類別的包裝。HttpContext 執行時，通常會使用該類別的 HttpContextWrapper 實例來呼叫物件上的 HttpContext 成員。

建構函式

名稱	Description
HttpContextBase()	初始化該類別以供繼承類別實例使用。 這個建構函式只能由繼承的類別呼叫。

屬性

名稱	Description
AllErrors	當在派生類別中覆寫時，會獲得一個在處理 HTTP 請求時累積的錯誤陣列（如有）。
AllowAsyncDuringSyncStages	當在衍生類別中實作時，會獲得或設定一個值，指示在 ASP.NET 請求處理的部分時間內，當非預期操作時是否被允許。
Application	當在衍生類別中覆寫時，會取得 HttpApplicationState 目前 HTTP 請求的物件。
ApplicationInstance	當在衍生類別中被覆寫時，會取得或設定 HttpApplication 當前 HTTP 請求的物件。
AsyncPreloadMode	當在衍生類別中實作時，會取得或設定一個包含與非同步預載模式相關的旗標的物件。
Cache	當在衍生類別中覆寫時，會取得 Cache 目前應用域的物件。
CurrentHandler	當在衍生類別中被覆寫時，會得到 IHttpHandler 代表目前執行中處理器的物件。
CurrentNotification	當在衍生類別中覆寫時，會獲得 RequestNotification 一個表示目前正在處理事件的 HttpApplication 值。
Error	當在衍生類別中覆寫時，會收到 HTTP 請求處理時累積的第一個錯誤（如果有的話）。
Handler	當在派生類別中被覆寫時，會取得或設定 IHttpHandler 負責處理 HTTP 請求的物件。
IsCustomErrorEnabled	當在衍生類別中覆寫時，會獲得一個值，指示目前 HTTP 請求是否啟用自訂錯誤。
IsDebuggingEnabled	當在派生類別中覆寫時，會獲得一個值，表示目前的 HTTP 請求是否處於除錯模式。
IsPostNotification	當在派生類別中覆寫時，會獲得一個值，表示事件是否 HttpApplication 已完成處理。
IsWebSocketRequest	當在衍生類別中實作時，會獲得一個值，指示該請求是否為 AspNetWebSocket 連線請求。
IsWebSocketRequestUpgrading	當在衍生類別中實作時，會獲得一個值，表示連線是否從 HTTP 連線升級為連線 AspNetWebSocket 。
Items	當 在派生類別中被覆寫時，會獲得一個鍵值集合，可用於在 HTTP 請求期間，模組與處理器間組織與共享資料。
PageInstrumentation	當 在衍生類別中實作時，會獲得此請求的頁面-儀器服務實例的參考。
PreviousHandler	當在衍生類別中被覆寫時，會取得 IHttpHandler 父處理器的物件。
Profile	當在衍生類別中覆寫時，會取得 ProfileBase 目前使用者設定檔的物件。
Request	當在衍生類別中覆寫時，會取得 HttpRequest 目前 HTTP 請求的物件。
Response	當在派生類別中覆寫時，會取得 HttpResponse 當前 HTTP 回應的物件。
Server	當在衍生類別中覆寫時，會取得 HttpServerUtility 提供網頁請求處理時所用方法的物件。
Session	當在衍生類別中覆寫時，會取得 HttpSessionState 目前 HTTP 請求的物件。
SkipAuthorization	當在衍生類別中被覆寫時，會獲得或設定一個值，指定物件是否 UrlAuthorizationModule 應該跳過當前請求的授權檢查。
ThreadAbortOnTimeout	當在衍生類別中實作時，會獲得或設定一個值，指定 ASP.NET 執行時在請求逾時時是否應呼叫服務該執行緒的執行緒 Abort()。
Timestamp	當在衍生類別中覆寫時，會獲得當前 HTTP 請求的初始時間戳記。
Trace	當在派生類別中覆寫時，會取得 TraceContext 當前 HTTP 回應的物件。
User	當在派生類別中覆寫時，會取得或設定當前 HTTP 請求的安全資訊。
WebSocketNegotiatedProtocol	當以衍生類別實作時，會取得伺服器傳送給客戶端以進行 AspNetWebSocket 連線的協商協定。
WebSocketRequestedProtocols	當在衍生類別中實作時，會得到客戶端請求的有序協定清單。

方法

名稱	Description
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	當在衍生類別中實作時，會 AspNetWebSocket 接受使用指定的使用者函式與選項物件的請求。
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	當以衍生類別實作時，會 AspNetWebSocket 使用指定的使用者函式接受請求。
AddError(Exception)	當在衍生類別中覆寫時，會為當前 HTTP 請求的例外集合加入例外。
AddOnRequestCompleted(Action<HttpContextBase>)	當 在衍生類別中實作時，會觸發一個虛擬事件，當請求的 HTTP 部分結束時會發生。
ClearError()	當在衍生類別中覆寫時，會清除目前 HTTP 請求的所有錯誤。
DisposeOnPipelineCompleted(IDisposable)	當在導出類別中實作時，能在請求的連接部分完成時呼叫AspNetWebSocket物件的方法Dispose()。
Equals(Object)	判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetGlobalResourceObject(String, String, CultureInfo)	當在衍生類別中覆寫時，會根據指定的 ClassKey 屬性 ResourceKey 以及物件獲得 CultureInfo 一個應用程式層級的資源物件。
GetGlobalResourceObject(String, String)	當在派生類別中覆寫時，會根據指定的 ClassKey 和 ResourceKey 屬性獲得一個應用層級的資源物件。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLocalResourceObject(String, String, CultureInfo)	當在衍生類別中覆寫時，會根據指定的 VirtualPath 和 ResourceKey 屬性，以及物件本身 CultureInfo ，獲得一個頁面層級的資源物件。
GetLocalResourceObject(String, String)	當在派生類別中被覆寫時，會根據指定的 VirtualPath 和 ResourceKey 屬性獲得一個頁面層級的資源物件。
GetSection(String)	當在派生類別中被覆寫時，會獲得當前應用程式預設配置的指定配置區段。
GetService(Type)	當在派生類別中被覆寫時，會回傳當前服務類型的物件。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
RemapHandler(IHttpHandler)	當在衍生類別中覆寫時，會指定請求的處理器。
RewritePath(String, Boolean)	當在派生類別中覆寫時，會透過指定的路徑及一個指定是否修改伺服器資源虛擬路徑的值來重寫 URL。
RewritePath(String, String, String, Boolean)	當在派生類別中覆寫時，會透過指定的路徑、路徑資訊、查詢字串資訊，以及指定用戶端檔案路徑是否設定為重寫路徑的值來重寫 URL。
RewritePath(String, String, String)	當在派生類別中覆寫時，會利用指定的路徑、路徑資訊和查詢字串資訊重寫 URL。
RewritePath(String)	當在衍生類別中覆寫時，會依照指定路徑重寫 URL。
SetSessionStateBehavior(SessionStateBehavior)	當在衍生類別中覆寫時，會設定支援 HTTP 請求所需的會話狀態行為類型。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)