DynamicRouteValueTransformer Klasse

Definition

Namespace:

Microsoft.AspNetCore.Mvc.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Paket:

Microsoft.AspNetCore.App.Ref v8.0.0

Quelle:

DynamicRouteValueTransformer.cs

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

Object

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.