DynamicRouteValueTransformer Classe

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Mvc.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Pacchetto:

Microsoft.AspNetCore.App.Ref v8.0.0

Fornisce un'astrazione per la modifica dinamica del valore della route per selezionare un'azione o una pagina del controller.

public ref class DynamicRouteValueTransformer abstract

public abstract class DynamicRouteValueTransformer

type DynamicRouteValueTransformer = class

Public MustInherit Class DynamicRouteValueTransformer

Ereditarietà

Object

DynamicRouteValueTransformer

Commenti

DynamicRouteValueTransformer può essere usato con MapDynamicControllerRoute<TTransformer>(IEndpointRouteBuilder, String) o MapDynamicPageRoute per implementare la logica personalizzata che seleziona un'azione o una pagina del controller.

I valori di route restituiti da un'implementazione TransformAsync(HttpContext, RouteValueDictionary) verranno usati per selezionare un'azione in base alla corrispondenza dei valori della route. Tutte le azioni che corrispondono ai valori di route verranno considerate candidati e potrebbero essere ulteriormente disambiguate da FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>) e IEndpointSelectorPolicy implementazioni come HttpMethodMatcherPolicy.

Le operazioni in un'istanza DynamicRouteValueTransformer verranno chiamate per ogni endpoint dinamico nella sequenza seguente:

• State è impostato
• TransformAsync(HttpContext, RouteValueDictionary)
• FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)

Le implementazioni registrate con la raccolta di servizi possono usare in modo sicuro i membri della classe per mantenere lo stato tra queste operazioni.

Le implementazioni devono essere registrate con la raccolta di DynamicRouteValueTransformer servizi come tipo DynamicRouteValueTransformer. Le implementazioni possono usare qualsiasi durata del servizio. Le implementazioni che usano State devono essere registrate come temporanee.

Costruttori

DynamicRouteValueTransformer()

Fornisce un'astrazione per la modifica dinamica del valore della route per selezionare un'azione o una pagina del controller.

Proprietà

State

Ottiene o imposta un valore di stato. Valore arbitrario passato al trasformatore da cui è stato registrato.

Metodi

FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)	Filtra il set di endpoint scelti come risultato della ricerca in base ai valori di route restituiti da TransformAsync(HttpContext, RouteValueDictionary).
TransformAsync(HttpContext, RouteValueDictionary)	Crea un set di valori di route trasformati che verranno usati per selezionare un'azione.