FilterContext.IsEffectivePolicy<TMetadata>(TMetadata) Methode

Definition

Namespace:

Microsoft.AspNetCore.Mvc.Filters

Assembly:

Microsoft.AspNetCore.Mvc.Abstractions.dll

Paket:

Microsoft.AspNetCore.App.Ref v8.0.0

Gibt einen Wert zurück, der angibt, ob die bereitgestellte IFilterMetadata die effektivste (spezifischste) Richtlinie ist, die auf die Aktion angewendet wird, die dem FilterContextzugeordnet ist.

public:
generic <typename TMetadata>
 where TMetadata : Microsoft::AspNetCore::Mvc::Filters::IFilterMetadata bool IsEffectivePolicy(TMetadata policy);

public bool IsEffectivePolicy<TMetadata> (TMetadata policy) where TMetadata : Microsoft.AspNetCore.Mvc.Filters.IFilterMetadata;

member this.IsEffectivePolicy : 'Metadata -> bool (requires 'Metadata :> Microsoft.AspNetCore.Mvc.Filters.IFilterMetadata)

Public Function IsEffectivePolicy(Of TMetadata As IFilterMetadata) (policy As TMetadata) As Boolean

Typparameter

TMetadata

Der Typ der Filterrichtlinie.

Parameter

policy

TMetadata

Die Filterrichtlinie instance.

Gibt zurück

Boolean

true , wenn die bereitgestellte IFilterMetadata die effektivste Richtlinie ist, andernfalls false.

Hinweise

Die IsEffectivePolicy<TMetadata>(TMetadata) -Methode wird verwendet, um eine allgemeine Konvention für Filter zu implementieren, die ein überschreibendes Verhalten definieren. Wenn mehrere Filter auf dasselbe übergreifende Problem angewendet werden können, definieren Sie eine gemeinsame Schnittstelle für die Filter (TMetadata), und implementieren Sie die Filter so, dass alle Implementierungen diese Methode aufrufen, um zu bestimmen, ob sie Maßnahmen ergreifen sollten.

Für instance kann ein globaler Filter überschrieben werden, indem ein Filterattribute für eine Aktionsmethode platziert wird. Die richtlinie, die direkt auf die Aktionsmethode angewendet wird, kann als spezifischer betrachtet werden.

Dieser Mechanismus zum Überschreiben basiert auf den Regeln der Reihenfolge und des Bereichs, die das Filtersystem bereitstellt, um die Reihenfolge der Filter zu steuern. Es liegt an der Implementierung von Filtern, dieses Protokoll kooperativ zu implementieren. Das Filtersystem hat keine angeborene Vorstellung von Außerkraftsetzungen, dies ist eine empfohlene Konvention.