HttpWorkerRequest 類別

  • 參考

定義

命名空間:
System.Web
組件:
System.Web.dll

這個抽象類別定義 ASP.NET Managed 程式碼處理要求所使用的基底背景工作方法和列舉類型 (Enumeration)。

public ref class HttpWorkerRequest abstract
[System.Runtime.InteropServices.ComVisible(false)]
public abstract class HttpWorkerRequest
[<System.Runtime.InteropServices.ComVisible(false)>]
type HttpWorkerRequest = class
Public MustInherit Class HttpWorkerRequest
繼承
Object
HttpWorkerRequest
衍生
屬性
ComVisibleAttribute

備註

在大部分情況下，您的程式碼不會直接處理 HttpWorkerRequest ，因為要求和回應資料會透過 HttpRequest 和 HttpResponse 類別公開。 某些內部 ASP.NET 類別會擴充此類別。 如果您的程式碼實作自己的裝載環境，則必須擴充此類別來呼叫 ProcessRequest 方法。 此外，您的程式碼可能會針對指定應用程式內的子要求執行目的建立衍生類別，以便將其實例傳遞至 ProcessRequest 。 在此情況下，衍生類別應該保留對目前 HttpWorkerRequest 的參考，並將大部分的方法委派給它。

建構函式

HttpWorkerRequest()

初始化 HttpWorkerRequest 類別的新執行個體。

欄位

HeaderAccept

指定 Accept HTTP 標頭的索引編號。
HeaderAcceptCharset

指定 Accept-Charset HTTP 標頭的索引編號。
HeaderAcceptEncoding

指定 Accept-Encoding HTTP 標頭的索引編號。
HeaderAcceptLanguage

指定 Accept-Language HTTP 標頭的索引編號。
HeaderAcceptRanges

指定 Accept-Ranges HTTP 標頭的索引編號。
HeaderAge

指定 Age HTTP 標頭的索引編號。
HeaderAllow

指定 Allow HTTP 標頭的索引編號。
HeaderAuthorization

指定 Authorization HTTP 標頭的索引編號。
HeaderCacheControl

表示 HTTP Cache-Control HTTP 標頭的索引。
HeaderConnection

指定 Connection HTTP 標頭的索引編號。
HeaderContentEncoding

指定 Content-Encoding HTTP 標頭的索引編號。
HeaderContentLanguage

指定 Content-Language HTTP 標頭的索引編號。
HeaderContentLength

指定 Content-Length HTTP 標頭的索引編號。
HeaderContentLocation

指定 Content-Location HTTP 標頭的索引編號。
HeaderContentMd5

指定 Content-MD5 HTTP 標頭的索引編號。
HeaderContentRange

指定 Content-Range HTTP 標頭的索引編號。
HeaderContentType

指定 Content-Type HTTP 標頭的索引編號。
HeaderCookie

指定 Cookie HTTP 標頭的索引編號。
HeaderDate

指定 Date HTTP 標頭的索引編號。
HeaderEtag

指定 ETag HTTP 標頭的索引編號。
HeaderExpect

指定 Except HTTP 標頭的索引編號。
HeaderExpires

指定 Expires HTTP 標頭的索引編號。
HeaderFrom

指定 From HTTP 標頭的索引編號。
HeaderHost

指定 Host HTTP 標頭的索引編號。
HeaderIfMatch

指定 If-Match HTTP 標頭的索引編號。
HeaderIfModifiedSince

指定 If-Modified-Since HTTP 標頭的索引編號。
HeaderIfNoneMatch

指定 If-None-Match HTTP 標頭的索引編號。
HeaderIfRange

指定 If-Range HTTP 標頭的索引編號。
HeaderIfUnmodifiedSince

指定 If-Unmodified-Since HTTP 標頭的索引編號。
HeaderKeepAlive

指定 Keep-Alive HTTP 標頭的索引編號。
HeaderLastModified

指定 Last-Modified HTTP 標頭的索引編號。
HeaderLocation

指定 Location HTTP 標頭的索引編號。
HeaderMaxForwards

指定 Max-Forwards HTTP 標頭的索引編號。
HeaderPragma

指定 Pragma HTTP 標頭的索引編號。
HeaderProxyAuthenticate

指定 Proxy-Authenticate HTTP 標頭的索引編號。
HeaderProxyAuthorization

指定 Proxy-Authorization HTTP 標頭的索引編號。
HeaderRange

指定 Range HTTP 標頭的索引編號。
HeaderReferer

指定 Referer HTTP 標頭的索引編號。
HeaderRetryAfter

指定 Retry-After HTTP 標頭的索引編號。
HeaderServer

指定 Server HTTP 標頭的索引編號。
HeaderSetCookie

指定 Set-Cookie HTTP 標頭的索引編號。
HeaderTe

指定 TE HTTP 標頭的索引編號。
HeaderTrailer

指定 Trailer HTTP 標頭的索引編號。
HeaderTransferEncoding

指定 Transfer-Encoding HTTP 標頭的索引編號。
HeaderUpgrade

指定 Upgrade HTTP 標頭的索引編號。
HeaderUserAgent

指定 User-Agent HTTP 標頭的索引編號。
HeaderVary

指定 Vary HTTP 標頭的索引編號。
HeaderVia

指定 Via HTTP 標頭的索引編號。
HeaderWarning

指定 Warning HTTP 標頭的索引編號。
HeaderWwwAuthenticate

指定 WWW-Authenticate HTTP 標頭的索引編號。
ReasonCachePolicy

指定要求的原因。
ReasonCacheSecurity

指定要求的原因。
ReasonClientDisconnect

指定要求的原因。
ReasonDefault

指定要求的原因。 預設值是 ReasonResponseCacheMiss。
ReasonFileHandleCacheMiss

指定要求的原因。
ReasonResponseCacheMiss

指定要求的原因。
RequestHeaderMaximum

指定 Maximum HTTP 要求標頭的索引編號。
ResponseHeaderMaximum

指定 Maximum HTTP 回應標頭的索引編號。

屬性

MachineConfigPath

取得 Machine.config 檔的完整實體路徑。
MachineInstallDirectory

取得安裝 ASP.NET 二進位碼檔案位置的目錄的實體路徑。
RequestTraceIdentifier

取得目前要求對應的 Windows 事件追蹤 ID。
RootWebConfigPath

取得根 Web.config 檔的完整實體路徑。
SupportsAsyncFlush

取得值，指出是否支援非同步清除作業。
SupportsAsyncRead

取得值，指出是否支援非同步讀取作業。

方法

BeginFlush(AsyncCallback, Object)

將目前已緩衝的回應傳送到用戶端。
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

開始進行要求之實體內容的非同步讀取作業。
CloseConnection()

結束與用戶端的連接。
EndFlush(IAsyncResult)

等候暫止的非同步清除作業完成。
EndOfRequest()

供 Runtime 使用來告知 HttpWorkerRequest 目前要求的要求處理已經完成。
EndRead(IAsyncResult)

等候暫止的非同步讀取作業完成。
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
FlushResponse(Boolean)

將所有的暫止回應資料傳送至用戶端。
GetAppPath()

傳回目前正在執行之伺服器應用程式的虛擬路徑。
GetAppPathTranslated()

將實體路徑傳回至目前正在執行的伺服器應用程式。
GetAppPoolID()

在衍生類別中覆寫時，傳回目前 URL 的應用程式集區 ID。
GetBytesRead()

取得從用戶端讀入的位元組數。
GetClientCertificate()

在衍生類別中覆寫時，從用戶端發出的要求中，取得憑證欄位 (依 X.509 標準指定)。
GetClientCertificateBinaryIssuer()

以二進位格式，取得憑證簽發者。
GetClientCertificateEncoding()

在衍生類別中覆寫時，傳回用戶端憑證編碼所使用的 Encoding 物件。
GetClientCertificatePublicKey()

在衍生類別中覆寫時，取得與目前憑證關聯的 PublicKey 物件。
GetClientCertificateValidFrom()

在衍生類別中覆寫時，取得憑證生效的日期。 日期會隨著國際設定而變。
GetClientCertificateValidUntil()

取得憑證到期日。
GetConnectionID()

在衍生類別中覆寫時，傳回目前連接的 ID。
GetFilePath()

在衍生類別中覆寫時，傳回所要求之 URI 的虛擬路徑。
GetFilePathTranslated()

傳回所要求 URI 的實體檔案路徑 (並且將它從虛擬路徑轉譯為實體路徑：例如，「/proj1/page.aspx」為「c:\dir\page.aspx」)。
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetHttpVerbName()

傳回要求標頭的指定成員。
GetHttpVersion()

提供要求的 HTTP 版本 (例如，「HTTP/1.1」) 的存取。
GetKnownRequestHeader(Int32)

傳回對應至指定索引的標準 HTTP 要求標頭。
GetKnownRequestHeaderIndex(String)

傳回指定 HTTP 要求標頭的索引編號。
GetKnownRequestHeaderName(Int32)

傳回指定 HTTP 要求標頭的名稱。
GetKnownResponseHeaderIndex(String)

傳回指定的 HTTP 回應標頭的索引編號。
GetKnownResponseHeaderName(Int32)

傳回指定的 HTTP 回應標頭的名稱。
GetLocalAddress()

提供要求標頭之指定成員的存取權限。
GetLocalPort()

提供要求標頭之指定成員的存取權限。
GetPathInfo()

傳回具有 URL 擴充部分之資源的額外路徑資訊。 也就是，對於路徑 /virdir/page.html/tail，GetPathInfo 值是 /tail。
GetPreloadedEntityBody()

傳回已經讀取的 HTTP 要求主體的部分。
GetPreloadedEntityBody(Byte[], Int32)

使用指定的緩衝資料和位元組位移，取得目前已經讀取的 HTTP 要求主體的部分。
GetPreloadedEntityBodyLength()

取得目前已經讀取的 HTTP 要求主體的部分長度。
GetProtocol()

當在衍生類別中覆寫時，傳回 HTTP 通訊協定 (HTTP 或 HTTPS)。
GetQueryString()

傳回在要求 URL 中指定的查詢字串。
GetQueryStringRawBytes()

在衍生類別中覆寫時，將回應查詢字串當做位元組陣列傳回。
GetRawUrl()

傳回附加查詢字串之要求標頭中包含的 URL 路徑。
GetRemoteAddress()

提供要求標頭之指定成員的存取權限。
GetRemoteName()

在衍生類別中覆寫時，傳回用戶端電腦的名稱。
GetRemotePort()

提供要求標頭之指定成員的存取權限。
GetRequestReason()

在衍生類別中覆寫時，傳回要求的原因。
GetServerName()

在衍生類別中覆寫時，傳回本機伺服器的名稱。
GetServerVariable(String)

傳回與要求相關之伺服器變數字典的單一伺服器變數。
GetStatusDescription(Int32)

傳回描述指定 HTTP 狀態碼名稱的字串。
GetTotalEntityBodyLength()

取得整個 HTTP 要求主體的長度。
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
GetUnknownRequestHeader(String)

傳回非標準 HTTP 要求標頭值。
GetUnknownRequestHeaders()

取得所有非標準 HTTP 標頭名稱值配對。
GetUriPath()

傳回所要求 URI 的虛擬路徑。
GetUrlContextID()

在衍生類別中覆寫時，傳回目前連接的內容 ID。
GetUserToken()

在衍生類別中覆寫時，傳回用戶端的 Impersonation Token。
GetVirtualPathToken()

取得要求虛擬路徑的模擬語彙基元。
HasEntityBody()

傳回值，指出要求是否包含主體資料。
HeadersSent()

傳回值，指出 HTTP 回應標頭是否已經傳送到目前要求的用戶端。
IsClientConnected()

傳回值，指出用戶端連接是否仍然有作用。
IsEntireEntityBodyIsPreloaded()

傳回值，指出所有要求資料是否可以使用，而且不需要從用戶端進一步讀取。
IsSecure()

傳回值，指出連線是否使用 SSL。
MapPath(String)

傳回對應於指定虛擬路徑的實體路徑。
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ReadEntityBody(Byte[], Int32)

讀取來自用戶端的要求資料 (沒有事先載入時)。
ReadEntityBody(Byte[], Int32, Int32)

使用要讀取之指定的緩衝區、位元組位移和最大位元組，從用戶端讀取要求資料 (不預先載入時)。
SendCalculatedContentLength(Int32)

在訊息主體小於或等於 2 GB 的回應上，加入 Content-Length HTTP 標頭。
SendCalculatedContentLength(Int64)

在訊息主體大於 2 GB 的回應上，加入 Content-Length HTTP 標頭。
SendKnownResponseHeader(Int32, String)

將標準 HTTP 標頭加入回應。
SendResponseFromFile(IntPtr, Int64, Int64)

將指定檔案的內容加入回應，並且指定檔案裡的開始位置和傳送的位元組數目。
SendResponseFromFile(String, Int64, Int64)

將指定檔案的內容加入回應，並且指定檔案裡的開始位置和傳送的位元組數目。
SendResponseFromMemory(Byte[], Int32)

將指定的位元組數目從位元組陣列加入回應。
SendResponseFromMemory(IntPtr, Int32)

將指定的位元組數目從記憶體區塊加入回應。
SendStatus(Int32, String)

指定回應的 HTTP 狀態碼和狀態原因，例如 SendStatus(200, "Ok") 。
SendUnknownResponseHeader(String, String)

將非標準的 HTTP 標頭加入回應。
SetEndOfSendNotification(HttpWorkerRequest+EndOfSendNotification, Object)

當所有回應資料都傳送時，登錄以供選擇性告知。
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱