<AppContextSwitchOverrides>-Element

Artikel
06/05/2023

Definiert mindestens eine Option, die von der AppContext-Klasse für die Bereitstellung eines Mechanismus zum Deaktivieren neuer Funktionen verwendet wird.

<configuration>
<runtime>
<AppContextSwitchOverrides>

Syntax

<AppContextSwitchOverrides value="name1=value1[[;name2=value2];...]" />

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	BESCHREIBUNG
`value`	Erforderlich. Definiert mindestens einen Schalternamen und die zugehörigen booleschen Werte.

value-Attribut

Wert	BESCHREIBUNG
„name=value“	Ein vordefinierter Schaltername zusammen mit seinem Wert (`true` oder `false`). Mehrere Schaltername/-wert-Paare werden durch Semikolons („;“) getrennt. Eine Liste der vordefinierten Schalternamen, die vom .NET Framework unterstützt werden, finden Sie im Abschnitt „Anmerkungen“.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`runtime`	Enthält Informationen über Laufzeitinitialisierungsoptionen.

Bemerkungen

Ab .NET Framework 4.6 ermöglicht das <AppContextSwitchOverrides>-Element in einer Konfigurationsdatei Aufrufenden einer API, zu bestimmen, ob ihre App neue Funktionen nutzen oder die Kompatibilität mit früheren Versionen einer Bibliothek beibehalten kann. Wenn sich beispielsweise das Verhalten einer API zwischen zwei Versionen einer Bibliothek geändert hat, ermöglicht das <AppContextSwitchOverrides>-Element Aufrufenden dieser API, das neue Verhalten für Versionen der Bibliothek zu deaktivieren, die die neue Funktionalität unterstützen. Für Apps, die APIs im .NET Framework aufrufen, kann das <AppContextSwitchOverrides> Element auch Aufrufenden erlauben, deren Apps auf eine frühere Version von .NET Framework abzielen, sich für neue Funktionen zu entscheiden, wenn ihre App in einer Version von .NET Framework ausgeführt wird, die diese Funktionalität enthält.

Das value-Attribut des <AppContextSwitchOverrides>-Elements besteht aus einer einzelnen Zeichenfolge, die aus mindestens einem bzw. mehreren durch Semikolons getrennten Name-Wert-Paaren besteht. Jeder Name identifiziert einen Kompatibilitätsschalter, und der entsprechende Wert ist ein boolescher Wert (true oder false), der angibt, ob der Schalter festgelegt ist. Standardmäßig ist der Schalter false, und Bibliotheken stellen die neue Funktionalität bereit. Sie stellen die vorherige Funktionalität nur bereit, wenn der Schalter festgelegt ist (d. h. sein Wert ist true). Dadurch können Bibliotheken neues Verhalten für eine vorhandene API bereitstellen, während Aufrufer, die auf das vorherige Verhalten angewiesen sind, die neue Funktionalität deaktivieren können.

.NET Framework unterstützt die folgenden Schalter:

Schaltername	BESCHREIBUNG	Eingeführt
`Switch.MS.Internal.` `DoNotApplyLayoutRoundingToMarginsAndBorderThickness`	Steuert, ob Windows Presentation Foundation einen älteren Algorithmus für das Steuerelementlayout verwendet. Weitere Informationen finden Sie unter Entschärfung: WPF-Layout.	.NET Framework 4.6
`Switch.MS.Internal.` `UseSha1AsDefaultHashAlgorithmForDigitalSignatures`	Steuert, ob der Standardalgorithmus, der zum Signieren von Teilen eines Pakets von PackageDigitalSignatureManager verwendet wird, SHA1 oder SHA256 ist. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.7.1
`Switch.System.Activities.` `UseMD5CryptoServiceProviderForWFDebugger`	Bei Festlegung auf `false` ist das Debuggen von XAML-basierten Workflowprojekten mit Visual Studio möglich, wenn FIPS aktiviert ist. Ohne dies wird in Aufrufen von Methoden in der System.Activities-Assembly NullReferenceException ausgelöst.	.NET Framework 4.7
`Switch.System.Activities.` `UseMD5ForWFDebugger`	Steuert, ob die Prüfsumme für eine Workflowinstanz im Debugger MD5 oder SHA1 verwendet.	.NET Framework 4.7
`Switch.System.Activities.` `UseSHA1HashForDebuggerSymbols`	Steuert, ob Workflowprüfsummen-Hashing den SHA1-Algorithmus verwendet, der in .NET Framework 4.7 (`true`) als Standard eingeführt wurde, oder ob der SHA256-Standardalgorithmus verwendet wird, der in .NET Framework 4.8 (`false`) als Standard eingeführt wurde. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.8
`Switch.System.Diagnostics.` `IgnorePortablePDBsInStackTraces`	Steuert, ob Stapelüberwachungen, die bei der Verwendung portabler PDBs abgerufen werden, Quelldatei- und Zeileninformationen enthalten können. `false`, um Quelldatei- und Zeileninformationen einzuschließen; andernfalls `true`.	.NET Framework 4.7.2
`Switch.System.Drawing.` `DontSupportPngFramesInIcons`	Steuert, ob die Icon.ToBitmap-Methode eine Ausnahme auslöst, wenn ein Icon-Objekt über PNG-Frames verfügt. Weitere Informationen finden Sie unter Entschärfung: PNG-Bilder in Symbolobjekten.	.NET Framework 4.6
`Switch.System.Drawing.Text.` `DoNotRemoveGdiFontsResourcesFromFontCollection`	Bestimmt, ob System.Drawing.Text.PrivateFontCollection-Objekte ordnungsgemäß verworfen werden, wenn sie der Auflistung durch die PrivateFontCollection.AddFontFile(String)-Methode hinzugefügt werden. `true`, um das Legacyverhalten beizubehalten; `false`, um alle privaten Schriftartobjekte zu verwerfen.	.NET Framework 4.7.2
`Switch.System.Drawing.Printing.` `OptimizePrintPreview`	Steuert, ob die Leistung von PrintPreviewDialog für Netzwerkdrucker optimiert ist. Weitere Informationen finden Sie unter Übersicht über das PrintPreviewDialog-Steuerelement.	.NET Framework 4.6
`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	Steuert, ob jahresweite Überprüfungen für japanische Kalenderzeiträume erzwungen werden. `true`, um Jahresbereichsüberprüfungen zu erzwingen, und `false`, um sie zu deaktivieren (Standardverhalten). Weitere Informationen finden Sie unter Arbeiten mit Kalendern.	.NET Framework 4.6
`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	Steuert, ob bei Analysevorgängen nur „1“ als erstes Jahr eines japanischen Kalenderzeitraums erkannt wird. `true`, um nur „1“ zu erkennen; `false`, um entweder „1“ oder Gannen (Standardverhalten) zu erkennen. Weitere Informationen finden Sie unter Arbeiten mit Kalendern.	.NET Framework 4.6
`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	Steuert, ob das erste Jahr eines japanischen Kalenderzeitraums in Formatierungsvorgängen als „1“ oder Gannen dargestellt wird. `true`, um das erste Jahr des Zeitraums mit „1“ zu formatieren; `false`, um es als Gannen zu formatieren (Standardverhalten). Weitere Informationen finden Sie unter Arbeiten mit Kalendern.	.NET Framework 4.6
`Switch.System.Globalization.NoAsyncCurrentCulture`	Steuert, ob asynchrone Vorgänge nicht aus dem Kontext des aufrufenden Threads fließen. Weitere Informationen finden Sie unter CurrentCulture und CurrentUICulture werden über mehrere Aufgaben übertragen.	.NET Framework 4.6
`Switch.System.IdentityModel.` `DisableMultipleDNSEntriesInSANCertificate`	Steuert, ob die X509CertificateClaimSet.FindClaims-Methode versucht, den Anspruchstyp nur mit dem letzten DNS-Eintrag abzugleichen. Weitere Informationen finden Sie unter Entschärfung: X509CertificateClaimSet.FindClaims-Methode.	.NET Framework 4.6.1
`Switch.System.IdentityModel.` `EnableCachedEmptyDefaultAuthorizationContext`	Steuert, ob AuthorizationContext.Empty ein veränderliches Objekt zurückgeben darf.	.NET Framework 4.6
`Switch.System.IO.BlockLongPaths`	Steuert, ob Pfade, die länger als `MAX_PATH` (260 Zeichen) sind, eine PathTooLongExceptionauslösen. Weitere Informationen finden Sie unter Unterstützung für lange Pfade.	.NET Framework 4.6.2
`Switch.System.IO.Compression.` `DoNotUseNativeZipLibraryForDecompression`	Steuert, ob native Betriebssystemroutinen für die Dekomprimierung von der DeflateStream-Klasse verwendet werden. `false` zur Verwendung nativer APIs; `true`, um die DeflateStream-Implementierung zu verwenden.	.NET Framework 4.7.2
`Switch.System.IO.Compression.ZipFile.` `UseBackslash`	Verwendet den umgekehrten Schrägstrich („\“) anstelle des Schrägstrichs („/“) als Pfadtrennzeichen in der ZipArchiveEntry.FullName-Eigenschaft. Weitere Informationen finden Sie unter Entschärfung: Pfadtrennzeichen für ZipArchiveEntry.FullName.	.NET Framework 4.6.1
`Switch.System.IO.Ports.` `DoNotCatchSerialStreamThreadExceptions`	Steuert, ob Betriebssystemausnahmen, die in Hintergrundthreads ausgelöst werden, die mit SerialPort-Streams erstellt wurden, den Prozess beenden.	.NET Framework 4.7.1
`Switch.System.IO.` `UseLegacyPathHandling`	Steuert, ob die Normalisierung von Legacypfaden verwendet wird, und URI-Pfade von den Methoden Path.GetDirectoryName und Path.GetPathRoot unterstützt werden. Weitere Informationen finden Sie unter Entschärfung: Pfadnormalisierung und Entschärfung: Überprüfen von Pfaden auf Doppelpunkte.	.NET Framework 4.6.2
`Switch.System.` `MemberDescriptorEqualsReturnsFalseIfEquivalent`	Steuert, ob ein Gleichheitstest die MemberDescriptor.Category-Eigenschaft eines Objekts mit der MemberDescriptor.Description-Eigenschaft des zweiten Objekts vergleicht. Weitere Informationen finden Sie unter Falsche Implementierung von MemberDescriptor.Equals.	.NET Framework 4.6.2
`Switch.System.Net.` `DontCheckCertificateEKUs`	Deaktiviert die Überprüfung des Objektbezeichners (Object Identifier, OID) des Zertifikats „Erweiterte Schlüsselverwendung“ (Enhanced Key Usage, EKU). Eine EKU-Erweiterung ist eine Sammlung von OIDs, die Anwendungen kennzeichnen, die den Schlüssel verwenden.	.NET Framework 4.6
`Switch.System.Net.` `DontEnableSchSendAuxRecord`	Deaktiviert die Entschärfung von TLS1.0 Browser Exploit Against SSL/TLS (BEAST) durch Deaktivieren der Nutzung von SCH_SEND_AUX_RECORD.	.NET Framework 4.6
`Switch.System.Net.` `DontEnableSchUseStrongCrypto`	Steuert, ob die Klassen System.Net.ServicePointManager und System.Net.Security.SslStream das SSL 3.0-Protokoll verwenden können. Weitere Informationen finden Sie unter Entschärfung: TLS-Protokolle.	.NET Framework 4.6
`Switch.System.Net.` `DontEnableSystemDefaultTlsVersions`	Deaktiviert die Möglichkeit, SystemDefault-TLS-Versionen auf einen Standardwert von Tls12, Tls11 und Tls zurückzusetzen.	.NET Framework 4.7
`Switch.System.Net.` `DontEnableTlsAlerts`	Deaktiviert serverseitige SslStream-TLS-Warnungen.	.NET Framework 4.7
`Switch.System.Runtime.InteropServices.` `DoNotMarshalOutByrefSafeArrayOnInvoke`	Steuert, ob ByRef SafeArray-Parameter in COM-Interopereignissen zurück in nativen Code (`false`) gemarshallt werden, oder ob das Marshalling zurück zum nativen Code deaktiviert ist (`true`).	.NET Framework 4.8
`Switch.System.Runtime.Serialization.` `DoNotUseECMAScriptV6EscapeControlCharacter`	Steuert, ob DataContractJsonSerializer einige Steuerelementzeichen auf den ECMAScript V6- und V8-Standards basierend serialisiert. Weitere Informationen finden Sie unter Entschärfung: Serialisierung von Steuerzeichen mit dem DataContractJsonSerializer	.NET Framework 4.7
`Switch.System.Runtime.Serialization.` `DoNotUseTimeZoneInfo`	Steuert, ob DataContractJsonSerializer mehrere Anpassungen oder nur eine einzelne Anpassung für eine Zeitzone unterstützt. Wenn `true`, wird der TimeZoneInfo-Typ verwendet, um Datums- und Uhrzeitdaten zu serialisieren und zu deserialisieren. Andernfalls wird der TimeZone-Typ verwendet, der nicht mehrere Anpassungsregeln unterstützt.	.NET Framework 4.6.2
`Switch.System.Runtime.Serialization.UseNewMaxArraySize`	Steuert, ob System.Runtime.Serialization.ObjectManager während der Serialisierung und Deserialisierung von Objekten eine größere Arraygröße verwendet. Legen Sie diesen Schalter auf `true` fest, um die Leistung der Serialisierung und Deserialisierung großer Objektgraphen nach Typen wie BinaryFormatter zu verbessern.	.NET Framework 4.7.2
`Switch.System.Security.ClaimsIdentity.` `SetActorAsReferenceWhenCopyingClaimsIdentity`	Steuert, ob der ClaimsIdentity(IIdentity)-Konstruktor die Eigenschaft des neuen Objekts ClaimsIdentity.Actor mit einem vorhandenen Objektverweis festlegt. Weitere Informationen finden Sie unter Entschärfung: ClaimsIdentity-Konstruktor.	.NET Framework 4.6.2
`Switch.System.Security.Cryptography.` `AesCryptoServiceProvider.DontCorrectlyResetDecryptor`	Steuert, ob der Versuch, eine AesCryptoServiceProvider-Entschlüsselungsmethode wiederzuverwenden, eine CryptographicException auslöst. Weitere Informationen finden Sie unter Die AesCryptoServiceProvider-Entschlüsselungsmethode stellt eine wiederverwendbare Transformation bereit.	.NET Framework 4.6.2
`Switch.System.Security.Cryptography.` `DoNotAddrOfCspParentWindowHandle`	Steuert, ob der Wert der CspParameters.ParentWindowHandle-Eigenschaft ein IntPtr ist, der den Speicherort eines Fensterhandles darstellt, oder ob es sich um ein Fensterhandle (ein HWND) handelt. Weitere Informationen finden Sie unter Entschärfung: CspParameters.ParentWindowHandle erwartet ein HWND.	.NET Framework 4.7
`Switch.System.Security.Cryptography.` `UseLegacyFipsThrow`	Steuert, ob die Verwendung von verwalteten Kryptografieklassen im FIPS-Modus eine CryptographicException (`true`) auslöst, oder auf der Implementierung von Systembibliotheken (`false`) basiert.	.NET Framework 4.8
`Switch.System.Security.Cryptography.Pkcs.` `UseInsecureHashAlgorithms`	Bestimmt, ob der Standardwert für einige SignedCMS-Vorgänge SHA1 oder SHA256 ist. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.7.1
`Switch.System.Security.Cryptography.X509Certificates.` `ECDsaCertificateExtensions.UseLegacyPublicKeyReader`	Steuert, ob die ECDsaCertificateExtensions.GetECDsaPublicKey-Methode alle benannten Kurven ordnungsgemäß verarbeitet, die vom Betriebssystem (`false`) unterstützt werden, oder ob das Legacyverhalten wiederhergestellt wird.	.NET Framework 4.8
`Switch.System.Security.Cryptography.Xml.` `UseInsecureHashAlgorithms`	Bestimmt, ob der Standardwert für einige SignedXML-Vorgänge SHA1 oder SHA256 ist. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.7.1
`Switch.System.ServiceModel.` `AllowUnsignedToHeader`	Bestimmt, ob der `TransportWithMessageCredential`-Sicherheitsmodus Nachrichten mit einem nicht signierten „to“-Header zulässt. Dies ist ein Aktivierungsfeature. Weitere Informationen finden Sie unter Änderungen der Runtime in .NET Framework Version 4.6.1.	.NET Framework 4.6.1
`Switch.System.ServiceModel.` `DisableAddressHeaderCollectionValidation`>	Steuert, ob der AddressHeaderCollection(IEnumerable<AddressHeader>)-Konstruktor eine ArgumentException auslöst, wenn eines der Elemente den Wert `null` aufweist.	.NET Framework 4.7.1
`Switch.System.IdentityModel.` `DisableCngCertificates`	Bestimmt, ob der Versuch, X509-Zertifikate mit einem CSG-Schlüsselspeicheranbieter zu verwenden, eine Ausnahme auslöst. Weitere Informationen finden Sie unter Unterstützung der WCF-Transportsicherheit für Zertifikate, die mithilfe der CNG gespeichert wurden.	.NET Framework 4.6.1
`Switch.System.ServiceModel.` `DisableExplicitConnectionCloseHeader`	Wenn Sie den HTTP-Transport mit einem selbstgehosteten Dienst verwenden, bewirkt das Festlegen dieses Werts auf `true`, dass WCF eine Anwendung ignoriert, die den `Connection: close`-Header den Antwortheadern für eine Anforderung hinzufügt. Wenn Sie diesen Wert auf `false` festlegen, kann der `Connection: close`-Header den Antwortheadern hinzugefügt werden, was zum Schließen des Anforderungssockets führt, nachdem eine Antwort gesendet wurde.	.NET Framework 4.6
`Switch.System.ServiceModel.` `DisableOperationContextAsyncFlow`	Behandelt Deadlocks, die daraus resultieren, dass Instanzen eines eintrittsinvarianten Diensts auf jeweils einen Ausführungsthread beschränkt werden.	.NET Framework 4.6.2
`Switch.System.ServiceModel.` `DisableUsingServicePointManagerSecurityProtocols`	Bestimmt zusammen mit `Switch.System.Net.DontEnableSchUseStrongCrypto`, ob die WCF-Nachrichtensicherheit TLS 1.1 und TLS 1.2 verwendet.	.NET Framework 4.7
`Switch.System.ServiceModel.` `DontEnableSystemDefaultTlsVersions`	Ein Wert von `false` legt die Standardkonfiguration fest, sodass das Protokoll vom Betriebssystem ausgewählt werden kann. Ein Wert von `true` legt die Standardeinstellung auf das höchste verfügbare Protokoll fest. (Auch im Servicing Branch früherer Frameworkversionen verfügbar)	.NET Framework 4.7.1
`Switch.System.ServiceModel.` `UseSha1InMsmqEncryptionAlgorithm`	Bestimmt, ob der Standardalgorithmus für die Nachrichtensignatur für MSMQ-Nachrichten in WCF SHA1 oder SHA256 ist. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.7.1
`Switch.System.ServiceModel.` `UseSha1InPipeConnectionGetHashAlgorithm`	Steuert, ob WCF einen SHA1- oder SHA256-Hash verwendet, um zufällige Namen für Named Pipes zu generieren. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.7.1
`Switch.System.ServiceModel.Internals` `IncludeNullExceptionMessageInETWTrace`	Steuert, ob eine NullReferenceException ausgelöst wird, wenn die Ausnahmemeldung NULL ist.	.NET Framework 4.7
`Switch.System.ServiceProcess.` `DontThrowExceptionsOnStart`	Steuert, ob beim Starten des Diensts ausgelöste Ausnahmen an den Aufrufer der ServiceBase.Run-Methode weitergegeben werden.	.NET Framework 4.7.1
`Switch.System.Threading.UseNetCoreTimer`	Steuert, ob Timer-Instanzen Leistungsverbesserungen für Umgebungen mit hoher Skalierung nutzen. Wenn `true`, sind die Leistungsverbesserungen aktiviert, wenn `false` (der Standardwert), sind sie deaktiviert.	.NET Framework 4.8
`Switch.System.Uri.` `DontEnableStrictRFC3986ReservedCharacterSets`	Bestimmt, ob bestimmte prozentcodierte Zeichen, die manchmal decodiert wurden, jetzt konsistent linkscodiert werden. Wenn `true`, werden sie decodiert, andernfalls `false`.	.NET Framework 4.7.2
`Switch.System.Uri.` `DontKeepUnicodeBidiFormattingCharacters`	Bestimmt die Behandlung bidirektionaler Unicode-Zeichen in URIs. `true` , um sie aus URIs zu entfernen; `false`, um sie beizubehalten und die Prozentcodierung für sie durchzuführen.	.NET Framework 4.7.2
`Switch.System.Windows.Controls.Grid.` `StarDefinitionsCanExceedAvailableSpace`	Bestimmt, ob Windows Presentation Foundation einen alten Algorithmus (`true`) oder einen neuen Algorithmus (`false`) bei der Zuweisung von Speicherplatz zu *-Spalten anwendet. Weitere Informationen finden Sie unter Entschärfung: Platzzuweisung an mit Stern gekennzeichnete Spalten durch das Rastersteuerelement.	.NET Framework 4.7
`Switch.System.Windows.Controls.TabControl.` `SelectionPropertiesCanLagBehindSelectionChangedEvent`	Steuert, ob ein Selektor oder ein Registerkartensteuerelement immer den Wert seiner ausgewählten Werteigenschaft aktualisiert, bevor das Auswahländerungsereignis ausgelöst wird.	.NET Framework 4.7.1
`Switch.System.Windows.Controls.Text.` `UseAdornerForTextboxSelectionRendering`	Bestimmt, ob das nicht Adorner-basierte Auswahlrendering für die Steuerelemente TextBox und PasswordBox verfügbar ist, um verstopften Text zu verhindern (`false`), oder ob Text nur in der Adorner-Ebene gerendert wird (`true`).	.NET Framework 4.7.2
`Switch.System.Windows.Data.Binding.` `IListIndexerHidesCustomIndexer`	Steuert, ob benutzerdefinierte IList-Indexer von der System.Windows.Data.Binding-Klasse falsch (`true`) oder ordnungsgemäß (`false`) verwendet werden.	.NET Framework 4.8
`Switch.System.Windows.DoNotScaleForDpiChanges`	Bestimmt, ob DPI-Änderungen pro System (ein Wert von `false`) oder pro Monitor (ein Wert von `true`) auftreten.	.NET Framework 4.6.2
`Switch.System.Windows.` `DoNotUsePresentationDpiCapabilityTier2OrGreater`	Steuert, ob Verbesserungen bei der Größenanpassung von Steuerelementen in einem System.Windows.Interop.HwndHost deaktiviert (`true`) oder aktiviert (`false`) sind, wenn WPF im „Pro Monitor“-Modus ausgeführt wird.	.NET Framework 4.8
`Switch.System.Windows.Forms.` `DisconnectUiaProvidersOnWmDestroy`	Steuert, ob Anbieter getrennt werden, wenn das entsprechende Steuerungsfenster zerstört wird (`true`) oder nicht (`false`). Diese Option bietet eine Opt-In zu einem Leistungskorrektur, um einen Verlust von IRawElementProviderSimple Objekten zu beheben.	.NET Framework 4.8
`Switch.System.Windows.Forms.` `DomainUpDown.UseLegacyScrolling`	Bestimmt, ob der Entwickler die DomainUpDown.UpButton()-Aktion speziell behandeln muss, wenn der Steuerelementtext vorhanden ist. `true`, um die UpButton()-Aktion zu behandeln; `false`, damit die DomainUpDown.UpButton()- und DomainUpDown.DownButton()-Aktionen ordnungsgemäß synchronisiert werden.	.NET Framework 4.7.2
`Switch.System.Windows.Forms.` `DontSupportReentrantFilterMessage`	Deaktiviert den Code, der einer benutzerdefinierten IMessageFilter.PreFilterMessage-Implementierung ermöglicht, Nachrichten sicher zu filtern, ohne eine Ausnahme auszulösen, wenn die Application.FilterMessage-Methode aufgerufen wird. Weitere Informationen finden Sie unter Entschärfung: Benutzerdefinierte IMessageFilter.PreFilterMessage-Implementierungen.	.NET Framework 4.6.1
`Switch.System.Windows.Forms.` `UseLegacyContextMenuStripSourceControlValue`	Bestimmt, ob die ContextMenuStrip.SourceControl-Eigenschaft die Quellcodeverwaltung zurückgibt, wenn der Benutzer das Menü über ein geschachteltes ToolStripMenuItem-Steuerelement öffnet. `true`, um `null` zurückzugeben, das Legacyverhalten; `false`, um die Quellcodeverwaltung zurückzugeben.	.NET Framework 4.7.2
`Switch.System.Windows.Forms.UseLegacyToolTipDisplay`	Steuert, ob die Unterstützung für den QuickInfo-Aufruf deaktiviert (`true`) oder aktiviert ist (`false`). Zum Aktivieren der QuickInfo-Aufrufunterstützung müssen auch ältere Barrierefreiheitsfeatures, die von `Switch.UseLegacyAccessibilityFeatures`, `Switch.UseLegacyAccessibilityFeatures.2` und `Switch.UseLegacyAccessibilityFeatures.3` definiert sind, alle deaktiviert (auf `false` festgelegt) werden.	.NET Framework 4.8
`Switch.System.Windows.Input.Stylus.` `EnablePointerSupport`	Bestimmt, ob in WPF-Anwendungen ein optionaler Touch-/Eingabestiftstapel auf `WM_POINTER`-Basis aktiviert ist. Weitere Informationen finden Sie unter Entschärfung: Zeigerbasierte Touch- und Stiftunterstützung.	.NET Framework 4.7
`Switch.System.Windows.Markup.` `DoNotUseSha256ForMarkupCompilerChecksumAlgorithm`	Bestimmt, ob für Prüfsummen der Standardhashalgorithmus SHA256 (`false`) oder SHA1 (`true`) verwendet wird. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.	.NET Framework 4.7.2
`Switch.System.Windows.Media.ImageSourceConverter.` `OverrideExceptionWithNullReferenceException`	Steuert, ob anstelle der Ausnahme eine ältere NullReferenceException ausgelöst wird, die die Ursache der Ausnahme genauer angibt (z. B. eine DirectoryNotFoundException oder FileNotFoundException). Dies ist für die Verwendung durch Code vorgesehen, der von der Behandlung der NullReferenceException abhängt.	.NET Framework 4.7
`Switch.System.Workflow.ComponentModel.` `UseLegacyHashForXomlFileChecksum`	Steuert, ob das Prüfsummenhashing von XOML-Dateien in Workflowprojektbuilds den MD5-Algorithmus (`true`) verwendet, oder ob der in .NET Framework 4.8 als Standard eingeführte SHA256-Algorithmus verwendet wird. Microsoft empfiehlt SHA256 aufgrund der Konflikte mit MD5.	.NET Framework 4.8
`Switch.System.Workflow.Runtime.` `UseLegacyHashForSqlTrackingCacheKey`	Steuert, ob das Prüfsummenhashing von SqlTrackingService den MD5-Algorithmus (`true`) für zwischengespeicherte Zeichenfolgen verwendet, oder ob der in .NET Framework 4.8 als Standard eingeführte SHA256-Algorithmus verwendet wird. Microsoft empfiehlt SHA256 aufgrund der Konflikte mit MD5.	.NET Framework 4.8
`Switch.System.Workflow.Runtime.` `UseLegacyHashForWorkflowDefinitionDispenserCacheKey`	Steuert, ob das Prüfsummenhashing der Workflowruntime den MD5-Algorithmus (`true`) für zwischengespeicherte Workflowdefinitionen verwendet, oder ob der in .NET Framework 4.8 als Standard eingeführte SHA256-Algorithmus verwendet wird. Microsoft empfiehlt SHA256 aufgrund der Konflikte mit MD5.	.NET Framework 4.8
`Switch.UseLegacyAccessibilityFeatures`	Steuert, ob ab .NET Framework 4.7.1 verfügbare Barrierefreiheitsfeatures aktiviert oder deaktiviert sind.	.NET Framework 4.7.1
`Switch.UseLegacyAccessibilityFeatures.2`	Steuert, ob in .NET Framework 4.7.2 verfügbare Barrierefreiheitsfeatures aktiviert (`false`) oder deaktiviert (`true`) sind. Wenn `true`, muss `Switch.UseLegacyAccessibilityFeatures` auch `true` sein, um Barrierefreiheitsfeatures von .NET Framework 4.7.1 zu aktivieren.	.NET Framework 4.7.2
`Switch.UseLegacyAccessibilityFeatures.3`	Steuert, ob in .NET Framework 4.8 eingeführte Barrierefreiheitsfeatures aktiviert (`false`) oder deaktiviert (`true`) sind. Wenn `true`, müssen `Switch.UseLegacyAccessibilityFeatures` und `Switch.UseLegacyAccessibilityFeatures.2` ebenfalls `true` sein.	.NET Framework 4.8
`Switch.UseLegacyToolTipDisplay`	Steuert, ob QuickInfos angezeigt werden, wenn Benutzer*innen den Mauszeiger über ein WPF-Steuerelement bewegen (`true`), oder ob sie sowohl im Tastaturfokus als auch über die Tastenkombination (`false`, Standardverhalten) angezeigt werden. Für Anwendungen, die unter .NET Framework 4.8 ausgeführt werden, aber auf frühere Versionen von .NET Framework ausgerichtet sind, erfordert die Aktivierung von Tastaturfokus und Tastenkombinationsunterstützung, dass `Switch.UseLegacyAccessibilityFeatures`, `Switch.UseLegacyAccessibilityFeatures.2` und `Switch.UseLegacyAccessibilityFeatures.3` alle auf `false` festgelegt sind.	.NET Framework 4.8
`Switch.System.Xml.` `IgnoreEmptyKeySequences`	Steuert, ob leere Schlüsselsequenzen in zusammengesetzten Schlüsseln von der XSD-Schemaüberprüfung ignoriert werden. Weitere Informationen finden Sie unter Entschärfung: XML-Schemavalidierung.	.NET Framework 4.6

Hinweis

Anstatt einer Anwendungskonfigurationsdatei ein AppContextSwitchOverrides-Element hinzuzufügen, können Sie die Schalter auch programmgesteuert festlegen, indem Sie die AppContext.SetSwitch-Methode aufrufen.

Bibliotheksentwickler können auch benutzerdefinierte Schalter definieren, damit Aufrufer die in späteren Versionen ihrer Bibliotheken eingeführten geänderten Funktionen deaktivieren können. Weitere Informationen finden Sie in den Ausführungen zur AppContext-Klasse.

Schalter in ASP.NET-Apps

Sie können eine ASP.NET-Anwendung für die Verwendung von Kompatibilitätseinstellungen konfigurieren, indem Sie dem Abschnitt <appSettings> der web.config-Datei ein <Add>-Element hinzufügen.

Im folgenden Beispiel wird das <add>-Element verwendet, um dem <appSettings>-Abschnitt einer web.config-Datei zwei Einstellungen hinzuzufügen:

<appSettings>
  <add key="AppContext.SetSwitch:Switch.System.Globalization.NoAsyncCurrentCulture" value="true" />
  <add key="AppContext.SetSwitch:Switch.System.Uri.DontEnableStrictRFC3986ReservedCharacterSets" value="true" />
</appSettings>

Beispiel

Im folgenden Beispiel wird das AppContextSwitchOverrides-Element verwendet, um einen einzelnen Anwendungskompatibilitätsschalter (Switch.System.Globalization.NoAsyncCurrentCulture) zu definieren, der einen threadsübergreifenden Kulturfluss in asynchronen Methodenaufrufen verhindert.

<configuration>
   <runtime>
      <AppContextSwitchOverrides value="Switch.System.Globalization.NoAsyncCurrentCulture=true" />
   </runtime>
</configuration>

Im folgenden Beispiel wird das AppContextSwitchOverrides-Element verwendet, um die beiden Anwendungskompatibilitätsschalter Switch.System.Globalization.NoAsyncCurrentCulture und Switch.System.IO.BlockLongPaths zu definieren. Ein Semikolon trennt die beiden Name-Wert-Paare.

<configuration>
    <runtime>
       <AppContextSwitchOverrides
          value="Switch.System.Globalization.NoAsyncCurrentCulture=true;Switch.System.IO.BlockLongPaths=true" />
    </runtime>
</configuration>

Teilen über