DynamicRouteValueTransformer クラス

定義

名前空間:

Microsoft.AspNetCore.Mvc.Routing

アセンブリ:

Microsoft.AspNetCore.Mvc.Core.dll

パッケージ:

Microsoft.AspNetCore.App.Ref v8.0.0

コントローラーのアクションまたはページを選択するためにルート値を動的に操作するための抽象化を提供します。

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) 返されるルート値は、ルート値の照合に基づいてアクションを選択するために使用されます。 ルート値に一致するすべてのアクションは候補と見なされ、 などのHttpMethodMatcherPolicy実装だけでなく、 によってFilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)IEndpointSelectorPolicyさらにあいまいになる可能性があります。

インスタンスに対する 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)	アクションの選択に使用する変換されたルート値のセットを作成します。