UrlRoutingHandler 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
作為類別的基底類別,讓你能自訂 ASP.NET 路由如何處理請求。
public ref class UrlRoutingHandler abstract : System::Web::IHttpHandler
public abstract class UrlRoutingHandler : System.Web.IHttpHandler
type UrlRoutingHandler = class
interface IHttpHandler
Public MustInherit Class UrlRoutingHandler
Implements IHttpHandler
- 繼承
-
UrlRoutingHandler
- 實作
備註
你可以自訂路由 ASP.NET 如何處理請求,方法是將檔案副檔名映射到特定的路由處理器,而不是每個請求都用 UrlRoutingModule 類別作為路由處理器。
要自訂路由 ASP.NET 如何處理具有特定副檔名的 URL 請求,你可以建立一個從 UrlRoutingHandler 類別衍生的類別。 例如,你可以建立一個自訂的路由處理程序,處理副檔名 .abc為 的檔案請求。
若要註冊特定檔案副檔名的自訂處理程序,必須在 Web.config 檔案中新增該處理程序。 以下範例說明如何註冊一個自訂處理程序,用於以 IIS 6.0 或 IIS 7.0 以經典模式執行的 ASP.NET 網站。
<system.web>
<httpHandlers>
<add verb="*" path="*.abc"
type="Contoso.Routing.CustomRoutingHandler" />
</httpHandlers>
</system.web>
以下範例說明如何註冊同一處理器,用於執行於 IIS 7.0 中的 ASP.NET 網站。
<system.webServer>
<handlers>
<add verb="*" path="*.abc"
type="Contoso.Routing.CustomRoutingHandler"
resourceType="Unspecified" />
</handlers>
</system.webServer>
建構函式
| 名稱 | Description |
|---|---|
| UrlRoutingHandler() |
初始化 UrlRoutingHandler 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| IsReusable |
會獲得一個值,表示是否有其他請求可以使用該 UrlRoutingHandler 實例。 |
| RouteCollection |
取得或設定 ASP.NET 應用程式的定義路由集合。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的 物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ProcessRequest(HttpContext) |
處理一個與路由相符的 HTTP 請求。 |
| ProcessRequest(HttpContextBase) |
處理一個與路由相符的 HTTP 請求。 |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
| VerifyAndProcessRequest(IHttpHandler, HttpContextBase) |
當在衍生類別中覆寫時,會驗證 HTTP 處理器並執行處理請求所需的步驟。 |
明確介面實作
| 名稱 | Description |
|---|---|
| IHttpHandler.IsReusable |
會獲得一個值,表示是否有其他請求可以使用該 UrlRoutingHandler 實例。 |
| IHttpHandler.ProcessRequest(HttpContext) |
處理一個與路由相符的 HTTP 請求。 |