DynamicRouteValueTransformer Classe

Definição

Namespace:

Microsoft.AspNetCore.Mvc.Routing

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

Fornece uma abstração para manipular dinamicamente o valor da rota para selecionar uma ação ou página do controlador.

public ref class DynamicRouteValueTransformer abstract

public abstract class DynamicRouteValueTransformer

type DynamicRouteValueTransformer = class

Public MustInherit Class DynamicRouteValueTransformer

Herança

Object

DynamicRouteValueTransformer

Comentários

DynamicRouteValueTransformer pode ser usado com MapDynamicControllerRoute<TTransformer>(IEndpointRouteBuilder, String) ou MapDynamicPageRoute para implementar a lógica personalizada que seleciona uma ação ou página do controlador.

Os valores de rota retornados de uma TransformAsync(HttpContext, RouteValueDictionary) implementação serão usados para selecionar uma ação com base na correspondência dos valores de rota. Todas as ações que correspondem aos valores de rota serão consideradas como candidatas e poderão ser ainda mais desambiguadas por FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>) , bem como IEndpointSelectorPolicy implementações como HttpMethodMatcherPolicy.

As operações em uma DynamicRouteValueTransformer instância serão chamadas para cada ponto de extremidade dinâmico na seguinte sequência:

• State está definido
• TransformAsync(HttpContext, RouteValueDictionary)
• FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)

As implementações registradas com a coleção de serviços como transitórias podem usar com segurança os membros da classe para persistir o estado nessas operações.

As implementações devem ser registradas DynamicRouteValueTransformer com a coleção de serviços como o tipo DynamicRouteValueTransformer. As implementações podem usar qualquer tempo de vida do serviço. As implementações que fazem uso de State devem ser registradas como transitórias.

Construtores

DynamicRouteValueTransformer()

Fornece uma abstração para manipular dinamicamente o valor da rota para selecionar uma ação ou página do controlador.

Propriedades

State

Obtém ou define um valor de estado. Um valor arbitrário passado para o transformador de onde ele foi registrado.

Métodos

FilterAsync(HttpContext, RouteValueDictionary, IReadOnlyList<Endpoint>)	Filtra o conjunto de pontos de extremidade que foram escolhidos como resultado da pesquisa com base nos valores de rota retornados por TransformAsync(HttpContext, RouteValueDictionary).
TransformAsync(HttpContext, RouteValueDictionary)	Cria um conjunto de valores de rota transformados que serão usados para selecionar uma ação.