DynamicRouteValueTransformer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 abstractpublic abstract class DynamicRouteValueTransformertype DynamicRouteValueTransformer = classPublic MustInherit Class DynamicRouteValueTransformer- Héritage
-
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. |