DynamicRouteValueTransformer Classe

Définition

Espace de noms:

Microsoft.AspNetCore.Mvc.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Source:

DynamicRouteValueTransformer.cs

Fournit une abstraction pour manipuler dynamiquement la valeur d’itinéraire pour sélectionner une action ou une page de contrôleur.

public ref class DynamicRouteValueTransformer abstract

public abstract class DynamicRouteValueTransformer

type DynamicRouteValueTransformer = class

Public MustInherit Class DynamicRouteValueTransformer

Héritage

Object

DynamicRouteValueTransformer

Remarques

DynamicRouteValueTransformer peut être utilisé avec MapDynamicControllerRoute<TTransformer>(IEndpointRouteBuilder, String) ou MapDynamicPageRoute pour implémenter une logique personnalisée qui sélectionne une action ou une page de contrôleur.

Les valeurs de routage retournées par une TransformAsync(HttpContext, RouteValueDictionary) implémentation seront utilisées pour sélectionner une action en fonction de la correspondance des valeurs de routage. Toutes les actions qui correspondent aux valeurs d’itinéraire sont considérées comme des candidats et peuvent être davantage ambiguës par ainsi que IEndpointSelectorPolicy par FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>) des implémentations telles que HttpMethodMatcherPolicy.

Les opérations sur un DynamicRouteValueTransformer instance sont appelées pour chaque point de terminaison dynamique dans l’ordre suivant :

• State est défini
• TransformAsync(HttpContext, RouteValueDictionary)
• FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)

Les implémentations inscrites comme temporaires auprès de la collection de services peuvent utiliser en toute sécurité les membres de classe pour conserver l’état de ces opérations.

Les implémentations DynamicRouteValueTransformer doivent être inscrites avec la collection de services en tant que type DynamicRouteValueTransformer. Les implémentations peuvent utiliser n’importe quelle durée de vie du service. Les implémentations qui utilisent doivent State être inscrites comme temporaires.

Constructeurs

DynamicRouteValueTransformer()

Fournit une abstraction pour manipuler dynamiquement la valeur d’itinéraire pour sélectionner une action ou une page de contrôleur.

Propriétés

State

Obtient ou définit une valeur d’état. Valeur arbitraire passée au transformateur à partir duquel il a été inscrit.

Méthodes

FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)	Filtre l’ensemble de points de terminaison qui ont été choisis à la suite d’une recherche en fonction des valeurs d’itinéraire retournées par TransformAsync(HttpContext, RouteValueDictionary).
TransformAsync(HttpContext, RouteValueDictionary)	Crée un ensemble de valeurs de route transformées qui seront utilisées pour sélectionner une action.