IActionSelector.SelectBestCandidate Método

Definição

Namespace:

Microsoft.AspNetCore.Mvc.Infrastructure

Assembly:

Microsoft.AspNetCore.Mvc.Core.dll

Pacote:

Microsoft.AspNetCore.App.Ref v8.0.0

Origem:

IActionSelector.cs

Seleciona o melhor ActionDescriptor candidato de candidates para a solicitação atual associada contexta .

public:
 Microsoft::AspNetCore::Mvc::Abstractions::ActionDescriptor ^ SelectBestCandidate(Microsoft::AspNetCore::Routing::RouteContext ^ context, System::Collections::Generic::IReadOnlyList<Microsoft::AspNetCore::Mvc::Abstractions::ActionDescriptor ^> ^ candidates);

public Microsoft.AspNetCore.Mvc.Abstractions.ActionDescriptor? SelectBestCandidate (Microsoft.AspNetCore.Routing.RouteContext context, System.Collections.Generic.IReadOnlyList<Microsoft.AspNetCore.Mvc.Abstractions.ActionDescriptor> candidates);

abstract member SelectBestCandidate : Microsoft.AspNetCore.Routing.RouteContext * System.Collections.Generic.IReadOnlyList<Microsoft.AspNetCore.Mvc.Abstractions.ActionDescriptor> -> Microsoft.AspNetCore.Mvc.Abstractions.ActionDescriptor

Public Function SelectBestCandidate (context As RouteContext, candidates As IReadOnlyList(Of ActionDescriptor)) As ActionDescriptor

Parâmetros

context

RouteContext

O RouteContext associado à solicitação atual.

candidates

IReadOnlyList<ActionDescriptor>

O conjunto de ActionDescriptor candidatos.

Retornos

ActionDescriptor

O melhor ActionDescriptor candidato para a solicitação atual ou null.

Exceções

Microsoft.AspNetCore.Mvc.Internal.AmbiguousActionException

Gerada quando a seleção de ação resulta em uma ambiguidade.

AmbiguousActionException

Gerada quando a seleção de ação resulta em uma ambiguidade.

Comentários

Invoca restrições de ação associadas aos candidatos.

Usado pelo roteamento convencional depois de chamar SelectCandidates(RouteContext) para aplicar restrições de ação e desambiguar entre vários candidatos.

Usado pelo roteamento de atributo para aplicar restrições de ação e desambiguar entre vários candidatos.