IActionConstraint Interfejs

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Mvc.ActionConstraints

Zestaw:

Microsoft.AspNetCore.Mvc.Abstractions.dll

Pakiet:

Microsoft.AspNetCore.App.Ref v8.0.0

Obsługuje logikę warunkową, aby określić, czy skojarzona akcja jest prawidłowa do wybrania dla danego żądania.

public interface class IActionConstraint : Microsoft::AspNetCore::Mvc::ActionConstraints::IActionConstraintMetadata

public interface IActionConstraint : Microsoft.AspNetCore.Mvc.ActionConstraints.IActionConstraintMetadata

type IActionConstraint = interface
    interface IActionConstraintMetadata

Public Interface IActionConstraint
Implements IActionConstraintMetadata

Pochodne

Microsoft.AspNetCore.Mvc.ActionConstraints.ActionMethodSelectorAttribute

Microsoft.AspNetCore.Mvc.ActionConstraints.HttpMethodActionConstraint

Microsoft.AspNetCore.Mvc.ConsumesAttribute

Microsoft.AspNetCore.Mvc.WebApiCompatShim.OverloadActionConstraint

Implementuje

IActionConstraintMetadata

Uwagi

Ograniczenia akcji mają efekt pomocniczy tworzenia akcji z ograniczeniem zastosowanym lepszym dopasowaniem niż jedno bez.

Rozważ dwie akcje "A" i "B" z tą samą akcją i nazwą kontrolera. Akcja "A" zezwala tylko na metodę HTTP POST (za pośrednictwem ograniczenia) i akcję "B" nie ma ograniczeń.

Jeśli żądanie przychodzące jest żądaniem POST, element "A" jest uznawany za najlepsze dopasowanie, ponieważ oba te żądania są zgodne i mają ograniczenie. Jeśli żądanie przychodzące używa innego zlecenia, wybór "A" nie będzie prawidłowy ze względu na ograniczenie, więc "B" jest najlepszym dopasowaniem.

Ograniczenia akcji są również grupowane zgodnie z ich wartością zamówienia. Wszelkie ograniczenia z tą samą wartością grupy są uważane za część tych samych zasad aplikacji i będą wykonywane na tym samym etapie.

Etapy są uruchamiane w kolejności rosnącej Orderna podstawie wartości . Biorąc pod uwagę zestaw akcji, które są kandydatami do wyboru, następny etap do uruchomienia jest najniższą wartością Order dla każdego ograniczenia każdego kandydata, który jest większy niż kolejność ostatniego etapu.

Po zidentyfikowaniu kolejności etapu każda akcja ma wszystkie ograniczenia w tym etapie. Jeśli jakiekolwiek ograniczenie nie jest zgodne, ta akcja nie jest kandydatem do wyboru. Jeśli jakiekolwiek akcje z ograniczeniami w bieżącym stanie są nadal kandydatami, to są to "najlepsze" akcje, a ten proces powtórzy się z następnym etapem w zestawie "najlepszych" akcji. Jeśli po przetworzeniu kolejnych etapów "najlepszych" akcji żaden z kandydatów nie pozostanie, ten proces będzie powtarzany na zestawie "innych" działań kandydatów z tego etapu (tych bez ograniczenia).

Właściwości

Order

Kolejność ograniczeń.

Metody

Accept(ActionConstraintContext)

Określa, czy akcja jest prawidłowym kandydatem do wyboru.