DynamicRouteValueTransformer 類別

定義

命名空間:

Microsoft.AspNetCore.Mvc.Routing

組件:

Microsoft.AspNetCore.Mvc.Core.dll

套件:

Microsoft.AspNetCore.App.Ref v8.0.0

來源:

DynamicRouteValueTransformer.cs

提供抽象概念，以動態方式操作路由值以選取控制器動作或頁面。

public ref class DynamicRouteValueTransformer abstract

public abstract class DynamicRouteValueTransformer

type DynamicRouteValueTransformer = class

Public MustInherit Class DynamicRouteValueTransformer

繼承

Object

DynamicRouteValueTransformer

備註

DynamicRouteValueTransformer 可以搭配 MapDynamicControllerRoute<TTransformer>(IEndpointRouteBuilder, String) 或 MapDynamicPageRoute 來實作自訂邏輯，以選取控制器動作或頁面。

從實作傳回的 TransformAsync(HttpContext, RouteValueDictionary) 路由值將用來根據路由值的比對來選取動作。 符合路由值的所有動作都會被視為候選項目，而且可能會進一步厘清 FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)IEndpointSelectorPolicy ，以及 這類 HttpMethodMatcherPolicy 實作。

針對下列順序中的每個動態端點，將會呼叫 實例上的 DynamicRouteValueTransformer 作業：

• State 已設定
• TransformAsync(HttpContext, RouteValueDictionary)
• FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)

向服務集合註冊為暫時性的實作，可能會安全地使用這些作業的類別成員來保存狀態。

實作 DynamicRouteValueTransformer 應該向服務集合註冊為 類型 DynamicRouteValueTransformer 。 實作可以使用任何服務存留期。 使用 的 State 實作必須註冊為暫時性。

建構函式

DynamicRouteValueTransformer()

提供抽象概念，以動態方式操作路由值以選取控制器動作或頁面。

屬性

State

取得或設定狀態值。 傳遞至轉換程式之註冊位置的任意值。

方法

FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)	根據 傳 TransformAsync(HttpContext, RouteValueDictionary) 回的路由值，篩選選擇作為查閱結果的端點集。
TransformAsync(HttpContext, RouteValueDictionary)	建立一組轉換的路由值，以用來選取動作。