IActionConstraint Interfaz

Definición

Espacio de nombres:

Microsoft.AspNetCore.Mvc.ActionConstraints

Ensamblado:

Microsoft.AspNetCore.Mvc.Abstractions.dll

Paquete:

Microsoft.AspNetCore.App.Ref v8.0.0

Admite la lógica condicional para determinar si una acción asociada es válida para seleccionarse para la solicitud especificada.

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

Derivado

Microsoft.AspNetCore.Mvc.ActionConstraints.ActionMethodSelectorAttribute

Microsoft.AspNetCore.Mvc.ActionConstraints.HttpMethodActionConstraint

Microsoft.AspNetCore.Mvc.ConsumesAttribute

Microsoft.AspNetCore.Mvc.WebApiCompatShim.OverloadActionConstraint

Implementaciones

IActionConstraintMetadata

Comentarios

Las restricciones de acción tienen el efecto secundario de hacer que una acción con una restricción aplique una coincidencia mejor que una sin.

Considere dos acciones: "A" y "B" con el mismo nombre de acción y controlador. La acción "A" solo permite el método HTTP POST (a través de una restricción) y la acción "B" no tiene restricciones.

Si una solicitud entrante es post, "A" se considera la mejor coincidencia porque coincide y tiene una restricción. Si una solicitud entrante usa cualquier otro verbo, "A" no será válido para la selección debido a su restricción, por lo que "B" es la mejor coincidencia.

Las restricciones de acción también se agrupan según su valor de orden. Las restricciones con el mismo valor de grupo se consideran parte de la misma directiva de aplicación y se ejecutarán en la misma fase.

Las fases se ejecutan en orden ascendente en función del valor de Order. Dado un conjunto de acciones que son candidatas para la selección, la siguiente fase de ejecución es el valor más bajo de Order para cualquier restricción de cualquier candidato que sea mayor que el orden de la última fase.

Una vez identificado el orden de fase, cada acción tiene todas sus restricciones en esa fase ejecutada. Si alguna restricción no coincide, esa acción no es candidata para la selección. Si las acciones con restricciones en el estado actual siguen siendo candidatas, estas son las acciones "mejores" y este proceso se repetirá con la siguiente fase en el conjunto de acciones "mejores". Si después de procesar las fases posteriores de las acciones "mejores" no quedan candidatos, este proceso se repetirá en el conjunto de acciones candidatas "otras" de esta fase (aquellas sin restricción).

Propiedades

Order

Orden de restricción.

Métodos

Accept(ActionConstraintContext)

Determina si una acción es un candidato válido para la selección.