Freigeben über


MvcOptions Klasse

Definition

Stellt programmgesteuerte Konfiguration für das MVC-Framework bereit.

public ref class MvcOptions
public ref class MvcOptions : System::Collections::Generic::IEnumerable<Microsoft::AspNetCore::Mvc::Infrastructure::ICompatibilitySwitch ^>
public class MvcOptions
public class MvcOptions : System.Collections.Generic.IEnumerable<Microsoft.AspNetCore.Mvc.Infrastructure.ICompatibilitySwitch>
type MvcOptions = class
type MvcOptions = class
    interface seq<ICompatibilitySwitch>
    interface IEnumerable
Public Class MvcOptions
Public Class MvcOptions
Implements IEnumerable(Of ICompatibilitySwitch)
Vererbung
MvcOptions
Implementiert

Konstruktoren

MvcOptions()

Erstellt eine neue Instanz von MvcOptions.

Eigenschaften

AllowBindingHeaderValuesToNonStringModelTypes

Ruft einen Wert ab, der bestimmt, ob HeaderModelBinder an andere Typen als String oder an eine Auflistung von Stringgebunden werden soll, oder legt diesen fest. Wenn auf truefestgelegt ist, HeaderModelBinder würden sie an einfache Typen (z. B String. , Int32, Enumusw Boolean .) oder an eine Auflistung einfacher Typen gebunden. Der Standardwert der -Eigenschaft ist false.

AllowCombiningAuthorizeFilters

Ruft einen Wert ab, der bestimmt, ob Richtlinien für Instanzen von AuthorizeFilter in einer einzelnen effektiven Richtlinie kombiniert werden, oder legt diesen fest. Der Standardwert der -Eigenschaft ist false.

AllowEmptyInputInBodyModelBinding

Ruft das Flag ab, das entscheidet, ob die Textmodellbindung (z. B. für einen Aktionsmethodenparameter mit FromBodyAttribute) leere Eingabe als gültig behandeln soll, oder legt es fest. false standardmäßig.

AllowShortCircuitingValidationWhenNoValidatorsArePresent

Ruft einen Wert ab, der bestimmt, ob ValidationVisitor die Überprüfung kurzschließen kann, wenn ein Modell über keine zugeordneten Validierungsatoren verfügt, oder legt diesen fest.

AllowValidatingTopLevelNodes

Ruft einen Wert ab, der bestimmt, ob modellgebundene Aktionsparameter, Controllereigenschaften, Seitenhandlerparameter oder Seitenmodelleigenschaften überprüft werden (zusätzlich zur Überprüfung ihrer Elemente oder Eigenschaften). Wenn auf truefestgelegt ist, BindRequiredAttribute und ValidationAttributes auf diesen Knoten der obersten Ebene werden aktiviert. Andernfalls werden solche Attribute ignoriert.

CacheProfiles

Ruft ein Wörterbuch der CacheProfile-Namen ab, CacheProfile bei denen es sich um vordefinierte Einstellungen für die Antwortzwischenspeicherung handelt.

Conventions

Ruft eine Liste von IApplicationModelConvention Instanzen ab, die beim Ermitteln von Aktionen auf die ApplicationModel angewendet werden.

EnableActionInvokers

Ruft das Flag ab, das bestimmt, ob MVC die Erweiterbarkeit des Aktionsaufrufs verwenden soll, oder legt es fest. Dies ermöglicht benutzerdefinierte IActionInvokerFactory und IActionInvokerProvider wird während der Anforderungspipeline ausgeführt.

EnableEndpointRouting

Ruft einen Wert ab, der bestimmt, ob das Routing Endpunkte intern verwenden soll oder ob Legacyroutinglogik verwendet werden soll, oder legt diesen fest. Endpunktrouting wird verwendet, um HTTP-Anforderungen mit MVC-Aktionen abzugleichen und URLs mit IUrlHelperzu generieren.

Filters

Ruft eine Auflistung ab, die zum Erstellen von IFilterMetadata Filtern verwendet wird, die für alle Aktionen gelten.

FormatterMappings

Wird verwendet, um die Zuordnung zwischen dem URL-Format und dem entsprechenden Medientyp anzugeben.

InputFormatterExceptionPolicy

Ruft einen Wert ab, der bestimmt, wie das Modellbindungssystem Ausnahmen interpretiert, die von einem ausgelöst werden, oder legt ihn IInputFormatterfest. Der Standardwert der -Eigenschaft ist AllExceptions.

InputFormatters

Ruft eine Liste von IInputFormatters ab, die von dieser Anwendung verwendet werden.

MaxIAsyncEnumerableBufferLimit

Ruft die meiste Anzahl von Einträgen einer IAsyncEnumerable<T> ab, die puffert, ObjectResultExecutor oder legt diese fest.

Wenn Value ein instance von IAsyncEnumerable<T>ist, ObjectResultExecutor liest die Enumeration eifrig und fügt zu einer synchronen Auflistung hinzu, bevor der ausgewählte Formatierungsvorgang aufgerufen wird. Diese Eigenschaft bestimmt die größte Anzahl von Einträgen, die der Executor puffern darf.

MaxModelBindingCollectionSize

Ruft die maximale Größe einer komplexen Auflistung ab, die für die Modellbindung verwendet werden soll, oder legt diese fest. Wenn dieser Grenzwert erreicht ist, löst das Modellbindungssystem einen aus InvalidOperationException.

MaxModelBindingRecursionDepth

Ruft die maximale Rekursionstiefe des Modellbindungssystems ab oder legt diese fest. Die DefaultModelBindingContext löst ein aus InvalidOperationException , wenn mehr als diese Anzahl von IModelBinders auf dem Stapel sind. Das heißt, ein Versuch, sich über diese Ebene hinaus zu rekursieren, schlägt fehl.

MaxModelValidationErrors

Ruft die maximale Anzahl von Validierungsfehlern ab, die von dieser Anwendung zulässig sind, bevor weitere Fehler ignoriert werden, oder legt diese fest.

MaxValidationDepth

Ruft die maximale Tiefe ab, um den Validierungsbesucher beim Überprüfen einzuschränken, oder legt diese fest. Legen Sie auf fest null , um dieses Feature zu deaktivieren.

ValidationVisitor durchläuft den Objektgraph des Modells, das überprüft wird. Bei Modellen, die sehr umfassend oder unendlich rekursiv sind, führt die Validierung möglicherweise zu einem Stapelüberlauf.

Wenn nicht null, ValidationVisitor wird ausgelöst, wenn das Durchlaufen eines Objekts die maximal zulässige Validierungstiefe überschreitet.

ModelBinderProviders

Ruft eine Liste der IModelBinderProvidervon dieser Anwendung verwendeten s ab.

ModelBindingMessageProvider

Ruft den standardmäßigen ModelBindingMessageProvider ab. Änderungen hier werden in die ModelBindingMessageProvider Eigenschaft aller ModelMetadata Instanzen kopiert, es sei denn, sie werden in einem benutzerdefinierten überschrieben IBindingMetadataProvider.

ModelMetadataDetailsProviders

Ruft eine Liste von IMetadataDetailsProvider Instanzen ab, die zum Erstellen von ModelMetadata Instanzen verwendet werden.

ModelValidatorProviders

Ruft eine Liste der IModelValidatorProvidervon dieser Anwendung verwendeten s ab.

OutputFormatters

Ruft eine Liste von IOutputFormatters ab, die von dieser Anwendung verwendet werden.

RequireHttpsPermanent

Ruft den Standardwert für die Permanent-Eigenschaft von ab oder legt den Standardwert fest RequireHttpsAttribute.

RespectBrowserAcceptHeader

Ruft das Flag ab, das dazu führt, dass die Inhaltsverhandlung den Accept-Header ignoriert, wenn es den Medientyp /enthält, oder legt es fest. false standardmäßig.

ReturnHttpNotAcceptable

Ruft das Flag ab, das entscheidet, ob eine HTTP 406 Not Acceptable-Antwort zurückgegeben wird, wenn kein Formatierer zum Formatieren der Antwort ausgewählt wurde, oder legt es fest. false standardmäßig.

SslPort

Ruft den SSL-Port ab, der von dieser Anwendung verwendet wird, wenn RequireHttpsAttribute er verwendet wird, oder legt diesen fest. Wenn nicht festgelegt wird, wird der Port nicht in der geschützten URL angegeben, z. B. https://localhost/path.

SuppressAsyncSuffixInActionNames

Ruft einen Wert ab, der bestimmt, ob MVC das Suffix "Async" entfernt, das auf Controlleraktionsnamen angewendet wird, oder legt diesen fest.

ActionName wird verwendet, um die Route zur Aktion sowie die Ansichtssuche zu erstellen. Wenn true, schneidet MVC das Suffix "Async" ab, das auf Aktionsmethodennamen angewendet wird. Beispielsweise wird der Aktionsname für ProductsController.ListProductsAsync als ListProducts.kanonisiert. Daher ist es routenfähig /Products/ListProducts , wobei die Ansichten unter /Views/Products/ListProducts.cshtmlangezeigt werden.

Diese Option wirkt sich nicht auf werte aus, die mit ActionNameAttributeangegeben wurden.

SuppressBindingUndefinedValueToEnumType

Ruft einen Wert ab, der angibt, ob das Modellbindungssystem nicht definierte Werte an Enumerationstypen bindet, oder legt diesen fest. Der Standardwert der -Eigenschaft ist false.

SuppressImplicitRequiredAttributeForNonNullableReferenceTypes

Ruft einen Wert ab, der bestimmt, ob der Rückschluss von RequiredAttribute für Eigenschaften und Parameter von Verweistypen ohne NULL-Wert unterdrückt wird, oder legt diesen fest. Wenn false (der Standardwert), verhalten sich alle Verweistypen, die nicht nullable sind, als wenn [Required] angewendet wurde. Wenn true, wird dieses Verhalten unterdrückt. Nullable-Verweistypen und Verweistypen ohne Nullable verhalten sich für Validierungszwecke gleich.

SuppressInputFormatterBuffering

Ruft einen Wert ab, der bestimmt, ob die Pufferung für Eingabeformatierer deaktiviert ist, die synchron aus dem HTTP-Anforderungstext lesen, oder legt diesen fest.

SuppressOutputFormatterBuffering

Ruft das Flag ab, das bestimmt, ob die Pufferung für Ausgabeformatierer deaktiviert ist, die synchron in den HTTP-Antworttext schreiben, oder legt es fest.

ValidateComplexTypesIfChildValidationFails

Ruft einen Wert ab, der bestimmt, ob der Validierungsbesucher die Überprüfung eines komplexen Typs ausführt, wenn die Überprüfung für eine seiner untergeordneten Elemente fehlschlägt, oder legt diesen fest.

ValueProviderFactories

Ruft eine Liste der IValueProviderFactory von dieser Anwendung verwendeten Ab.

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator()

Stellt programmgesteuerte Konfiguration für das MVC-Framework bereit.

IEnumerable<ICompatibilitySwitch>.GetEnumerator()

Stellt programmgesteuerte Konfiguration für das MVC-Framework bereit.

Gilt für: