HttpWorkerRequest 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
這個抽象類別定義 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 = classPublic MustInherit Class HttpWorkerRequest- 繼承
-
HttpWorkerRequest
- 衍生
- 屬性
備註
在大部分情況下，您的程式碼不會直接處理 HttpWorkerRequest ，因為要求和回應資料會透過 HttpRequest 和 HttpResponse 類別公開。 某些內部 ASP.NET 類別會擴充此類別。 如果您的程式碼實作自己的裝載環境，則必須擴充此類別來呼叫 ProcessRequest 方法。 此外，您的程式碼可能會針對指定應用程式內的子要求執行目的建立衍生類別，以便將其實例傳遞至 ProcessRequest 。 在此情況下，衍生類別應該保留對目前 HttpWorkerRequest 的參考，並將大部分的方法委派給它。
建構函式
| HttpWorkerRequest() |
初始化 HttpWorkerRequest 類別的新執行個體。 |
欄位
| HeaderAccept |
指定 |
| HeaderAcceptCharset |
指定 |
| HeaderAcceptEncoding |
指定 |
| HeaderAcceptLanguage |
指定 |
| HeaderAcceptRanges |
指定 |
| HeaderAge |
指定 |
| HeaderAllow |
指定 |
| HeaderAuthorization |
指定 |
| HeaderCacheControl |
表示 HTTP |
| HeaderConnection |
指定 |
| HeaderContentEncoding |
指定 |
| HeaderContentLanguage |
指定 |
| HeaderContentLength |
指定 |
| HeaderContentLocation |
指定 |
| HeaderContentMd5 |
指定 |
| HeaderContentRange |
指定 |
| HeaderContentType |
指定 |
| HeaderCookie |
指定 |
| HeaderDate |
指定 |
| HeaderEtag |
指定 |
| HeaderExpect |
指定 |
| HeaderExpires |
指定 |
| HeaderFrom |
指定 |
| HeaderHost |
指定 |
| HeaderIfMatch |
指定 |
| HeaderIfModifiedSince |
指定 |
| HeaderIfNoneMatch |
指定 |
| HeaderIfRange |
指定 |
| HeaderIfUnmodifiedSince |
指定 |
| HeaderKeepAlive |
指定 |
| HeaderLastModified |
指定 |
| HeaderLocation |
指定 |
| HeaderMaxForwards |
指定 |
| HeaderPragma |
指定 |
| HeaderProxyAuthenticate |
指定 |
| HeaderProxyAuthorization |
指定 |
| HeaderRange |
指定 |
| HeaderReferer |
指定 |
| HeaderRetryAfter |
指定 |
| HeaderServer |
指定 |
| HeaderSetCookie |
指定 |
| HeaderTe |
指定 |
| HeaderTrailer |
指定 |
| HeaderTransferEncoding |
指定 |
| HeaderUpgrade |
指定 |
| HeaderUserAgent |
指定 |
| HeaderVary |
指定 |
| HeaderVia |
指定 |
| HeaderWarning |
指定 |
| HeaderWwwAuthenticate |
指定 |
| ReasonCachePolicy |
指定要求的原因。 |
| ReasonCacheSecurity |
指定要求的原因。 |
| ReasonClientDisconnect |
指定要求的原因。 |
| ReasonDefault |
指定要求的原因。 預設值是 ReasonResponseCacheMiss。 |
| ReasonFileHandleCacheMiss |
指定要求的原因。 |
| ReasonResponseCacheMiss |
指定要求的原因。 |
| RequestHeaderMaximum |
指定 |
| ResponseHeaderMaximum |
指定 |
屬性
| 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() |
在衍生類別中覆寫時，取得與目前憑證關聯的 |
| 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， |
| 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 的回應上，加入 |
| SendCalculatedContentLength(Int64) |
在訊息主體大於 2 GB 的回應上，加入 |
| SendKnownResponseHeader(Int32, String) |
將標準 HTTP 標頭加入回應。 |
| SendResponseFromFile(IntPtr, Int64, Int64) |
將指定檔案的內容加入回應，並且指定檔案裡的開始位置和傳送的位元組數目。 |
| SendResponseFromFile(String, Int64, Int64) |
將指定檔案的內容加入回應，並且指定檔案裡的開始位置和傳送的位元組數目。 |
| SendResponseFromMemory(Byte[], Int32) |
將指定的位元組數目從位元組陣列加入回應。 |
| SendResponseFromMemory(IntPtr, Int32) |
將指定的位元組數目從記憶體區塊加入回應。 |
| SendStatus(Int32, String) |
指定回應的 HTTP 狀態碼和狀態原因，例如 |
| SendUnknownResponseHeader(String, String) |
將非標準的 HTTP 標頭加入回應。 |
| SetEndOfSendNotification(HttpWorkerRequest+EndOfSendNotification, Object) |
當所有回應資料都傳送時，登錄以供選擇性告知。 |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
