DynamicRouteValueTransformer Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Abstraktion zum dynamischen Bearbeiten des Routenwerts bereit, um eine Controlleraktion oder -seite auszuwählen.
public ref class DynamicRouteValueTransformer abstract
public abstract class DynamicRouteValueTransformer
type DynamicRouteValueTransformer = class
Public MustInherit Class DynamicRouteValueTransformer
- Vererbung
-
DynamicRouteValueTransformer
Hinweise
DynamicRouteValueTransformer kann mit MapDynamicControllerRoute<TTransformer>(IEndpointRouteBuilder, String) oder MapDynamicPageRoute
verwendet werden, um benutzerdefinierte Logik zu implementieren, die eine Controlleraktion oder -seite auswählt.
Die von einer TransformAsync(HttpContext, RouteValueDictionary) Implementierung zurückgegebenen Routenwerte werden verwendet, um eine Aktion basierend auf dem Abgleich der Routenwerte auszuwählen. Alle Aktionen, die mit den Routenwerten übereinstimmen, werden als Kandidaten betrachtet und können durch FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)IEndpointSelectorPolicy implementierungen wie HttpMethodMatcherPolicyz. B. weiter eindeutig definiert werden.
Vorgänge für einen DynamicRouteValueTransformer instance werden für jeden dynamischen Endpunkt in der folgenden Reihenfolge aufgerufen:
- State ist festgelegt.
- TransformAsync(HttpContext, RouteValueDictionary)
- FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)
Implementierungen, die bei der Dienstsammlung als vorübergehend registriert sind, können Klassenmember sicher verwenden, um den Zustand über diese Vorgänge hinweg beizubehalten.
Implementierungen DynamicRouteValueTransformer sollten bei der Dienstsammlung als Typ DynamicRouteValueTransformerregistriert werden. Implementierungen können eine beliebige Dienstlebensdauer verwenden. Implementierungen, die von State verwenden, müssen als vorübergehend registriert werden.
Konstruktoren
DynamicRouteValueTransformer() |
Stellt eine Abstraktion zum dynamischen Bearbeiten des Routenwerts bereit, um eine Controlleraktion oder -seite auszuwählen. |
Eigenschaften
State |
Ruft einen Zustandswert ab oder legt einen Wert fest. Ein beliebiger Wert, der an den Transformator übergeben wird, von dem aus er registriert wurde. |
Methoden
FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>) |
Filtert den Satz von Endpunkten, die als Ergebnis der Suche ausgewählt wurden, basierend auf den von TransformAsync(HttpContext, RouteValueDictionary)zurückgegebenen Routenwerten. |
TransformAsync(HttpContext, RouteValueDictionary) |
Erstellt einen Satz von transformierten Routenwerten, die zum Auswählen einer Aktion verwendet werden. |