From deb38379b2af709ee7b85c408f69a9b8fba62cd7 Mon Sep 17 00:00:00 2001 From: gewarren Date: Tue, 1 Jul 2025 01:38:02 +0000 Subject: [PATCH 1/5] =?UTF-8?q?Bot=20=F0=9F=A4=96=20generated=20CleanRepo?= =?UTF-8?q?=20tool=20run?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/core/compatibility/aspnetcore.md | 281 ------------------ docs/core/compatibility/cryptography.md | 46 --- docs/core/compatibility/networking.md | 25 -- docs/core/compatibility/visualbasic.md | 28 -- .../6.0/duplex-synchronization-context.md | 38 --- .../wcf-client/6.0/net-standard-2-support.md | 40 --- .../wcf-client/8.0/configurationname-apis.md | 54 ---- docs/core/compatibility/wpf.md | 20 -- 8 files changed, 532 deletions(-) delete mode 100644 docs/core/compatibility/aspnetcore.md delete mode 100644 docs/core/compatibility/cryptography.md delete mode 100644 docs/core/compatibility/networking.md delete mode 100644 docs/core/compatibility/visualbasic.md delete mode 100644 docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md delete mode 100644 docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md delete mode 100644 docs/core/compatibility/wcf-client/8.0/configurationname-apis.md delete mode 100644 docs/core/compatibility/wpf.md diff --git a/docs/core/compatibility/aspnetcore.md b/docs/core/compatibility/aspnetcore.md deleted file mode 100644 index ea2cc092ca664..0000000000000 --- a/docs/core/compatibility/aspnetcore.md +++ /dev/null @@ -1,281 +0,0 @@ ---- -title: ASP.NET Core breaking changes -titleSuffix: "" -description: Lists the breaking changes in ASP.NET Core 3.0 and 3.1. -ms.date: 11/03/2020 -ms.author: scaddie ---- -# ASP.NET Core breaking changes for versions 3.0 and 3.1 - -ASP.NET Core provides the web app development features used by .NET Core. - -Select one of the following links for breaking changes in a specific version: - -* [ASP.NET Core 3.1](#aspnet-core-31) -* [ASP.NET Core 3.0](#aspnet-core-30) - -The following breaking changes in ASP.NET Core 3.0 and 3.1 are documented on this page: - -- [Obsolete Antiforgery, CORS, Diagnostics, MVC, and Routing APIs removed](#obsolete-antiforgery-cors-diagnostics-mvc-and-routing-apis-removed) -- [Authentication: Google+ deprecation](#authentication-google-deprecated-and-replaced) -- [Authentication: HttpContext.Authentication property removed](#authentication-httpcontextauthentication-property-removed) -- [Authentication: Newtonsoft.Json types replaced](#authentication-newtonsoftjson-types-replaced) -- [Authentication: OAuthHandler ExchangeCodeAsync signature changed](#authentication-oauthhandler-exchangecodeasync-signature-changed) -- [Authorization: AddAuthorization overload moved to different assembly](#authorization-addauthorization-overload-moved-to-different-assembly) -- [Authorization: IAllowAnonymous removed from AuthorizationFilterContext.Filters](#authorization-iallowanonymous-removed-from-authorizationfiltercontextfilters) -- [Authorization: IAuthorizationPolicyProvider implementations require new method](#authorization-iauthorizationpolicyprovider-implementations-require-new-method) -- [Caching: CompactOnMemoryPressure property removed](#caching-compactonmemorypressure-property-removed) -- [Caching: Microsoft.Extensions.Caching.SqlServer uses new SqlClient package](#caching-microsoftextensionscachingsqlserver-uses-new-sqlclient-package) -- [Data Protection: DataProtection.Blobs uses new Azure Storage APIs](#data-protection-dataprotectionblobs-uses-new-azure-storage-apis) -- [Hosting: AspNetCoreModule V1 removed from Windows Hosting Bundle](#hosting-aspnetcoremodule-v1-removed-from-windows-hosting-bundle) -- [Hosting: Generic host restricts Startup constructor injection](#hosting-generic-host-restricts-startup-constructor-injection) -- [Hosting: HTTPS redirection enabled for IIS out-of-process apps](#hosting-https-redirection-enabled-for-iis-out-of-process-apps) -- [Hosting: IHostingEnvironment and IApplicationLifetime types replaced](#hosting-ihostingenvironment-and-iapplicationlifetime-types-marked-obsolete-and-replaced) -- [Hosting: ObjectPoolProvider removed from WebHostBuilder dependencies](#hosting-objectpoolprovider-removed-from-webhostbuilder-dependencies) -- [HTTP: Browser SameSite changes impact authentication](#http-browser-samesite-changes-impact-authentication) -- [HTTP: DefaultHttpContext extensibility removed](#http-defaulthttpcontext-extensibility-removed) -- [HTTP: HeaderNames fields changed to static readonly](#http-headernames-constants-changed-to-static-readonly) -- [HTTP: Response body infrastructure changes](#http-response-body-infrastructure-changes) -- [HTTP: Some cookie SameSite default values changed](#http-some-cookie-samesite-defaults-changed-to-none) -- [HTTP: Synchronous IO disabled by default](#http-synchronous-io-disabled-in-all-servers) -- [Identity: AddDefaultUI method overload removed](#identity-adddefaultui-method-overload-removed) -- [Identity: UI Bootstrap version change](#identity-default-bootstrap-version-of-ui-changed) -- [Identity: SignInAsync throws exception for unauthenticated identity](#identity-signinasync-throws-exception-for-unauthenticated-identity) -- [Identity: SignInManager constructor accepts new parameter](#identity-signinmanager-constructor-accepts-new-parameter) -- [Identity: UI uses static web assets feature](#identity-ui-uses-static-web-assets-feature) -- [Kestrel: Connection adapters removed](#kestrel-connection-adapters-removed) -- [Kestrel: Empty HTTPS assembly removed](#kestrel-empty-https-assembly-removed) -- [Kestrel: Request trailer headers moved to new collection](#kestrel-request-trailer-headers-moved-to-new-collection) -- [Kestrel: Transport abstraction layer changes](#kestrel-transport-abstractions-removed-and-made-public) -- [Localization: APIs marked obsolete](#localization-resourcemanagerwithculturestringlocalizer-and-withculture-marked-obsolete) -- [Logging: DebugLogger class made internal](#logging-debuglogger-class-made-internal) -- [MVC: Controller action Async suffix removed](#mvc-async-suffix-trimmed-from-controller-action-names) -- [MVC: JsonResult moved to Microsoft.AspNetCore.Mvc.Core](#mvc-jsonresult-moved-to-microsoftaspnetcoremvccore) -- [MVC: Precompilation tool deprecated](#mvc-precompilation-tool-deprecated) -- [MVC: Types changed to internal](#mvc-pubternal-types-changed-to-internal) -- [MVC: Web API compatibility shim removed](#mvc-web-api-compatibility-shim-removed) -- [Razor: RazorTemplateEngine API removed](#razor-razortemplateengine-api-removed) -- [Razor: Runtime compilation moved to a package](#razor-runtime-compilation-moved-to-a-package) -- [Session state: Obsolete APIs removed](#session-state-obsolete-apis-removed) -- [Shared framework: Assembly removal from Microsoft.AspNetCore.App](#shared-framework-assemblies-removed-from-microsoftaspnetcoreapp) -- [Shared framework: Microsoft.AspNetCore.All removed](#shared-framework-removed-microsoftaspnetcoreall) -- [SignalR: HandshakeProtocol.SuccessHandshakeData replaced](#signalr-handshakeprotocolsuccesshandshakedata-replaced) -- [SignalR: HubConnection methods removed](#signalr-hubconnection-resetsendping-and-resettimeout-methods-removed) -- [SignalR: HubConnectionContext constructors changed](#signalr-hubconnectioncontext-constructors-changed) -- [SignalR: JavaScript client package name change](#signalr-javascript-client-package-name-changed) -- [SignalR: Obsolete APIs](#signalr-usesignalr-and-useconnections-methods-marked-obsolete) -- [SPAs: SpaServices and NodeServices console logger fallback default change](#spas-spaservices-and-nodeservices-no-longer-fall-back-to-console-logger) -- [SPAs: SpaServices and NodeServices marked obsolete](#spas-spaservices-and-nodeservices-marked-obsolete) -- [Target framework: .NET Framework not supported](#target-framework-net-framework-support-dropped) - -## ASP.NET Core 3.1 - -[!INCLUDE[HTTP: Browser SameSite changes impact authentication](~/includes/core-changes/aspnetcore/3.1/http-cookie-samesite-authn-impacts.md)] - -*** - -## ASP.NET Core 3.0 - -[!INCLUDE[Obsolete Antiforgery, CORS, Diagnostics, MVC, and Routing APIs removed](~/includes/core-changes/aspnetcore/3.0/obsolete-apis-removed.md)] - -*** - -[!INCLUDE[Authentication: Google+ deprecation](~/includes/core-changes/aspnetcore/3.0/authn-google-plus-authn-changes.md)] - -*** - -[!INCLUDE[Authentication: HttpContext.Authentication property removed](~/includes/core-changes/aspnetcore/3.0/authn-httpcontext-property-removed.md)] - -*** - -[!INCLUDE[Authentication: Newtonsoft.Json types replaced](~/includes/core-changes/aspnetcore/3.0/authn-apis-json-types.md)] - -*** - -[!INCLUDE[Authentication: OAuthHandler ExchangeCodeAsync signature changed](~/includes/core-changes/aspnetcore/3.0/authn-exchangecodeasync-signature-change.md)] - -*** - -[!INCLUDE[Authorization: AddAuthorization overload assembly change](~/includes/core-changes/aspnetcore/3.0/authz-assembly-change.md)] - -*** - -[!INCLUDE[Authorization: IAllowAnonymous removed from AuthorizationFilterContext.Filters](~/includes/core-changes/aspnetcore/3.0/authz-iallowanonymous-removed-from-collection.md)] - -*** - -[!INCLUDE[Authorization: IAuthorizationPolicyProvider implementations require new method](~/includes/core-changes/aspnetcore/3.0/authz-iauthzpolicyprovider-new-method.md)] - -*** - -[!INCLUDE[Caching: CompactOnMemoryPressure property removed](~/includes/core-changes/aspnetcore/3.0/caching-memory-property-removed.md)] - -*** - -[!INCLUDE[Caching: Microsoft.Extensions.Caching.SqlServer uses new SqlClient package](~/includes/core-changes/aspnetcore/3.0/caching-new-sqlclient-package.md)] - -*** - -[!INCLUDE[Caching: ResponseCaching types changed to internal](~/includes/core-changes/aspnetcore/3.0/caching-response-pubternal-to-internal.md)] - -*** - -[!INCLUDE[Data Protection: DataProtection.AzureStorage uses new Azure Storage APIs](~/includes/core-changes/aspnetcore/3.0/dataprotection-azstorage-using-azstorage-apis.md)] - -*** - -[!INCLUDE[Hosting: ANCM version 1 removed from hosting bundle](~/includes/core-changes/aspnetcore/3.0/hosting-ancmv1-hosting-bundle-removal.md)] - -*** - -[!INCLUDE[Hosting: Generic host restriction on Startup constructor injection](~/includes/core-changes/aspnetcore/3.0/hosting-generic-host-startup-ctor-restriction.md)] - -*** - -[!INCLUDE[Hosting: HTTPS redirection enabled for IIS OutOfProcess](~/includes/core-changes/aspnetcore/3.0/hosting-https-redirection-iis-outofprocess.md)] - -*** - -[!INCLUDE[Hosting: IHostingEnvironment and IApplicationLifetime types replaced](~/includes/core-changes/aspnetcore/3.0/hosting-ihostingenv-iapplifetime-types-replaced.md)] - -*** - -[!INCLUDE[Hosting: ObjectPoolProvider removed from WebHostBuilder dependencies](~/includes/core-changes/aspnetcore/3.0/hosting-objectpoolprovider-webhostbuilder-dependencies.md)] - -*** - -[!INCLUDE[HTTP: DefaultHttpContext extensibility removed](~/includes/core-changes/aspnetcore/3.0/http-defaulthttpcontext-extensibility-removed.md)] - -*** - -[!INCLUDE[HTTP: HeaderNames fields changed to static readonly](~/includes/core-changes/aspnetcore/3.0/http-headernames-constants-staticreadonly.md)] - -*** - -[!INCLUDE[HTTP: Response body infrastructure changes](~/includes/core-changes/aspnetcore/3.0/http-response-body-changes.md)] - -*** - -[!INCLUDE[HTTP: Some cookie SameSite default values changed](~/includes/core-changes/aspnetcore/3.0/http-cookie-samesite-defaults-change.md)] - -*** - -[!INCLUDE[HTTP: Synchronous IO disabled by default](~/includes/core-changes/aspnetcore/3.0/http-synchronous-io-disabled.md)] - -*** - -[!INCLUDE[Identity: AddDefaultUI method overload removed](~/includes/core-changes/aspnetcore/3.0/identity-ui-adddefaultui-overload-removed.md)] - -*** - -[!INCLUDE[Identity: UI Bootstrap version change](~/includes/core-changes/aspnetcore/3.0/identity-ui-bootstrap-version.md)] - -*** - -[!INCLUDE[Identity: SignInAsync throws exception for unauthenticated identity](~/includes/core-changes/aspnetcore/3.0/identity-signinasync-throws-exception.md)] - -*** - -[!INCLUDE[Identity: SignInManager constructor accepts new parameter](~/includes/core-changes/aspnetcore/3.0/identity-signinmanager-ctor-parameter.md)] - -*** - -[!INCLUDE[Identity: UI uses static web assets feature](~/includes/core-changes/aspnetcore/3.0/identity-ui-static-web-assets.md)] - -*** - -[!INCLUDE[Kestrel: Connection adapters removed](~/includes/core-changes/aspnetcore/3.0/kestrel-connection-adapters-removed.md)] - -*** - -[!INCLUDE[Kestrel: Empty HTTPS assembly removed](~/includes/core-changes/aspnetcore/3.0/kestrel-empty-assembly-removed.md)] - -*** - -[!INCLUDE[Kestrel: Request trailer headers moved to new collection](~/includes/core-changes/aspnetcore/3.0/kestrel-request-trailer-headers.md)] - -*** - -[!INCLUDE[Kestrel: Transport abstraction layer changes](~/includes/core-changes/aspnetcore/3.0/kestrel-transport-abstractions.md)] - -*** - -[!INCLUDE[Localization: APIs marked obsolete](~/includes/core-changes/aspnetcore/3.0/localization-apis-marked-obsolete.md)] - -*** - -[!INCLUDE[Logging: DebugLogger class made internal](~/includes/core-changes/aspnetcore/3.0/logging-debuglogger-to-internal.md)] - -*** - -[!INCLUDE[MVC: Controller action Async suffix removed](~/includes/core-changes/aspnetcore/3.0/mvc-action-async-suffix-trimmed.md)] - -*** - -[!INCLUDE[MVC: JsonResult moved to Microsoft.AspNetCore.Mvc.Core](~/includes/core-changes/aspnetcore/3.0/mvc-jsonresult-moved.md)] - -*** - -[!INCLUDE[MVC: Precompilation tool deprecated](~/includes/core-changes/aspnetcore/3.0/mvc-precompilation-tool-deprecated.md)] - -*** - -[!INCLUDE[MVC: Types changed to internal](~/includes/core-changes/aspnetcore/3.0/mvc-pubternal-to-internal.md)] - -*** - -[!INCLUDE[MVC: Web API compatibility shim removed](~/includes/core-changes/aspnetcore/3.0/mvc-webapi-compat-shim-removed.md)] - -*** - -[!INCLUDE[Razor: RazorTemplateEngine API removed](~/includes/core-changes/aspnetcore/3.0/razor-razortemplateengine-api-removed.md)] - -*** - -[!INCLUDE[Razor: Runtime compilation moved to a package](~/includes/core-changes/aspnetcore/3.0/razor-runtime-compilation-package.md)] - -*** - -[!INCLUDE[Session state: Obsolete APIs removed](~/includes/core-changes/aspnetcore/3.0/session-obsolete-apis-removed.md)] - -*** - -[!INCLUDE[Shared framework: Assembly removal from Microsoft.AspNetCore.App](~/includes/core-changes/aspnetcore/3.0/sharedfx-app-shared-framework-assemblies.md)] - -*** - -[!INCLUDE[Shared framework: Microsoft.AspNetCore.All removed](~/includes/core-changes/aspnetcore/3.0/sharedfx-all-framework-removed.md)] - -*** - -[!INCLUDE[SignalR: HandshakeProtocol.SuccessHandshakeData replaced](~/includes/core-changes/aspnetcore/3.0/signalr-successhandshakedata-replaced.md)] - -*** - -[!INCLUDE[SignalR: HubConnection methods removed](~/includes/core-changes/aspnetcore/3.0/signalr-hubconnection-methods-removed.md)] - -*** - -[!INCLUDE[SignalR: HubConnectionContext constructors changed](~/includes/core-changes/aspnetcore/3.0/signalr-hubconnectioncontext-ctors.md)] - -*** - -[!INCLUDE[SignalR: JavaScript client package name change](~/includes/core-changes/aspnetcore/3.0/signalr-js-client-package-name.md)] - -*** - -[!INCLUDE[SignalR: Obsolete APIs](~/includes/core-changes/aspnetcore/3.0/signalr-obsolete-apis.md)] - -*** - -[!INCLUDE[SPAs: SpaServices and NodeServices marked obsolete](~/includes/core-changes/aspnetcore/3.0/spas-spaservices-nodeservices-obsolete.md)] - -*** - -[!INCLUDE[SPAs: SpaServices and NodeServices console logger fallback default change](~/includes/core-changes/aspnetcore/3.0/spas-spaservices-nodeservices-fallback.md)] - -*** - -[!INCLUDE[Target framework: .NET Framework not supported](~/includes/core-changes/aspnetcore/3.0/targetfx-netfx-tfm-support.md)] - -*** diff --git a/docs/core/compatibility/cryptography.md b/docs/core/compatibility/cryptography.md deleted file mode 100644 index 82487fbfc1696..0000000000000 --- a/docs/core/compatibility/cryptography.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Cryptography breaking changes -description: Lists cryptography-related breaking changes in .NET Core 2.1-3.0. -ms.date: 04/22/2020 -ms.custom: linux-related-content ---- -# Cryptography breaking changes for .NET Core 2.1-3.0 - -The following breaking changes are documented on this page: - -| Breaking change | Version introduced | -| - | :-: | -| [BEGIN TRUSTED CERTIFICATE syntax no longer supported on Linux](#begin-trusted-certificate-syntax-no-longer-supported-for-root-certificates-on-linux) | 3.0 | -| [EnvelopedCms defaults to AES-256 encryption](#envelopedcms-defaults-to-aes-256-encryption) | 3.0 | -| [Minimum size for RSAOpenSsl key generation has increased](#minimum-size-for-rsaopenssl-key-generation-has-increased) | 3.0 | -| [.NET Core 3.0 prefers OpenSSL 1.1.x to OpenSSL 1.0.x](#net-core-30-prefers-openssl-11x-to-openssl-10x) | 3.0 | -| [CryptoStream.Dispose transforms final block only when writing](#cryptostreamdispose-transforms-final-block-only-when-writing) | 3.0 | -| [Boolean parameter of SignedCms.ComputeSignature is respected](#boolean-parameter-of-signedcmscomputesignature-is-respected) | 2.1 | - -## .NET Core 3.0 - -[!INCLUDE [begin-trusted-cert-linux](~/includes/core-changes/cryptography/3.0/begin-trusted-cert-linux.md)] - -*** - -[!INCLUDE[EnvelopedCms defaults to AES-256 encryption](~/includes/core-changes/cryptography/3.0/envelopedcms-defaults-to-aes256.md)] - -*** - -[!INCLUDE[Minimum size for RSAOpenSsl key generation has increased](~/includes/core-changes/cryptography/3.0/minimum-rsaopenssl-key-size-change.md)] - -*** - -[!INCLUDE[.NET Core 3.0 prefers OpenSSL 1.1.x to OpenSSL 1.0.x](~/includes/core-changes/cryptography/3.0/net-core-3-0-prefers-openssl-1-1-x.md)] - -*** - -[!INCLUDE [CryptoStream.Dispose transforms final block only when writing](~/includes/core-changes/cryptography/3.0/cryptography-cryptostream-dispose-final-block-write.md)] - -*** - -## .NET Core 2.1 - -[!INCLUDE [Boolean parameter of SignedCms.ComputeSignature is respected](~/includes/core-changes/cryptography/2.1/compute-signature-silent-parameter.md)] - -*** diff --git a/docs/core/compatibility/networking.md b/docs/core/compatibility/networking.md deleted file mode 100644 index 1d6f14255daa0..0000000000000 --- a/docs/core/compatibility/networking.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Networking breaking changes -description: Lists the breaking changes in networking in .NET Core 2.0 and 3.0. -ms.date: 05/05/2020 ---- -# Networking breaking changes in .NET Core 2.0 and 3.0 - -The following breaking changes are documented on this page: - -| Breaking change | Introduced version | -| - | - | -| [Default value of HttpRequestMessage.Version changed to 1.1](#default-value-of-httprequestmessageversion-changed-to-11) | 3.0 | -| [WebClient.CancelAsync doesn't always cancel immediately](#webclientcancelasync-doesnt-always-cancel-immediately) | 2.0 | - -## .NET Core 3.0 - -[!INCLUDE[Default value of HttpRequestMessage.Version changed to 1.1](~/includes/core-changes/networking/3.0/httprequestmessage-version-change.md)] - -*** - -## .NET Core 2.0 - -[!INCLUDE [behavior-change-webclient-cancelasync](../../../includes/core-changes/networking/2.0/behavior-change-webclient-cancelasync.md)] - -*** diff --git a/docs/core/compatibility/visualbasic.md b/docs/core/compatibility/visualbasic.md deleted file mode 100644 index 25f08e06d5407..0000000000000 --- a/docs/core/compatibility/visualbasic.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Visual Basic breaking changes -description: Lists the breaking changes in Visual Basic used with .NET Core 3.0. -ms.date: "05/25/2021" ---- -# Visual Basic breaking changes in .NET Core 3.0 - -The following is a list of breaking changes in Visual Basic: - -- [Types in Microsoft.VisualBasic.ApplicationServices namespace not available](#types-in-microsoftvisualbasicapplicationservices-namespace-not-available) -- [Types in Microsoft.VisualBasic.Devices namespace not available](#types-in-microsoftvisualbasicdevices-namespace-not-available) -- [Types in Microsoft.VisualBasic.MyServices namespace not available](#types-in-microsoftvisualbasicmyservices-namespace-not-available) -- [About and SplashScreen templates are broken](#about-and-splashscreen-templates-are-broken) - -## .NET Core 3.0 - -[!INCLUDE[Types in Microsoft.VisualBasic.ApplicationServices namespace not available](~/includes/core-changes/visualbasic/3.0/microsoft.visualbasic.applicationservices-unavailable.md)] - -*** -[!INCLUDE[Types in Microsoft.VisualBasic.Devices namespace not available](~/includes/core-changes/visualbasic/3.0/microsoft.visualbasic.devices-unavailable.md)] - -*** - -[!INCLUDE[Types in Microsoft.VisualBasic.MyServices namespace not available](~/includes/core-changes/visualbasic/3.0/microsoft.visualbasic.myservices-unavailable.md)] - -*** - -[!INCLUDE[About and SplashScreen templates are broken for Visual Basic](~/includes/core-changes/visualbasic/3.0/vb-winforms-splash-about-broken.md)] diff --git a/docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md b/docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md deleted file mode 100644 index a371b5297a1dc..0000000000000 --- a/docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: "Breaking change: DuplexChannelFactory captures synchronization context" -description: Learn about the breaking change in WCF Client 6.0 where the DuplexChannelFactory now captures the synchronization context when it's opened. -ms.date: 04/06/2023 ---- -# Duplex contract captures synchronization context - - now captures the synchronization context when it's opened, and it dispatches callbacks to the captured context. - -## Previous behavior - -In previous versions, failed to capture the current synchronization context when the channel factory was opened. - -## New behavior - -Starting in WCF Client 6.0 RC, captures the current synchronization context when opened and dispatches callbacks to the captured context. This behavior matches that of .NET Framework. - -## Version introduced - -WCF Client 6.0 RC - -## Type of breaking change - -This change is a [behavioral change](../../categories.md#behavioral-change). - -## Reason for change - -This change was made to fix a bug where callbacks were happening on the wrong thread. The new behavior matches .NET Framework functionality. - -## Recommended action - -If the new behavior is undesirable, you can revert to version 4.x behavior by applying the to your callback contract with the property set to `false`. - -## Affected APIs - -- [DuplexChannelFactory\.Open](xref:System.ServiceModel.Channels.CommunicationObject.Open) -- [DuplexChannelFactory\.BeginOpen](xref:System.ServiceModel.Channels.CommunicationObject.BeginOpen%2A) -- [DuplexChannelFactory\.EndOpen](xref:System.ServiceModel.Channels.CommunicationObject.EndOpen%2A) diff --git a/docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md b/docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md deleted file mode 100644 index 3bbab85dfa84c..0000000000000 --- a/docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: "Breaking change: WCF Client support for .NET Standard" -description: Learn about the breaking change in WCF Client 6.0 where it no longer supports .NET Standard 2.0. -ms.date: 01/17/2023 ---- -# WCF Client doesn't support .NET Standard - -The WCF Client 6.0 library targets .NET 6 and no longer supports .NET Standard 2.0. - -## Previous behavior - -Previously, you could add package references to WCF Client NuGet packages regardless of your project's target framework. For projects that targeted .NET Framework, WCF Client always used the *System.ServiceModel.dll* implementation in .NET Framework. - -## New behavior - -WCF Client packages target only .NET 6. Library projects that target .NET Standard 2.0 and reference WCF Client packages will now need to multi-target .NET Framework and .NET. - -In addition, the `System.ServiceModel.Duplex` and `System.ServiceModel.Security` packages are deprecated, and this is their last release. The types they contain have been moved to the [System.ServiceModel.Primitives package](https://www.nuget.org/packages/System.ServiceModel.Primitives). For binary compatibility, the final versions of the `System.ServiceModel.Duplex` and `System.ServiceModel.Security` packages forward their types to `System.ServiceModel.Primitives`. - -## Version introduced - -WCF Client 6.0 Preview 1 - -## Type of breaking change - -This change can affect [binary compatibility](../../categories.md#binary-compatibility). - -## Reason for change - -WCF Client releases previously targeted .NET Standard 2.0 to support both .NET (Core) and .NET Framework. This support helped developers modernize and migrate their existing WCF apps from .NET Framework to .NET. The change to remove support for .NET Standard was made so that WCF Client and WCF Client apps can take advantage of the new features and APIs available in .NET 6 and later versions. In addition, removing .NET Standard support reduces the size of the WCF Client NuGet packages, so the footprint is smaller during deployment. - -## Recommended action - -- If your WCF project targets .NET 6 or later, no change is needed. If it targets .NET Standard 2.0, you'll need to multi-target your WCF libraries. Add a conditional assembly reference to *System.ServiceModel.dll* for .NET Framework and conditionally add package references to WCF Client packages for .NET. - -- Remove references to the [System.ServiceModel.Duplex](https://www.nuget.org/packages/System.ServiceModel.Duplex) and [System.ServiceModel.Security](https://www.nuget.org/packages/System.ServiceModel.Security) packages, because they're no longer needed. - -## Affected APIs - -N/A diff --git a/docs/core/compatibility/wcf-client/8.0/configurationname-apis.md b/docs/core/compatibility/wcf-client/8.0/configurationname-apis.md deleted file mode 100644 index 3a7b5ca5eaa5a..0000000000000 --- a/docs/core/compatibility/wcf-client/8.0/configurationname-apis.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: "Removal of WCF APIs with a `configurationName` parameter" -description: Learn about the breaking change in WCF 8 where the APIs that accept a `configurationName` parameter have been removed. -ms.date: 11/13/2024 -ai-usage: ai-assisted -ms.custom: https://github.com/dotnet/docs/issues/43111 ---- - -# Removal of WCF APIs with a `configurationName` parameter - -The WCF APIs that accept either a `configurationName` parameter or an `endpointConfigurationName` parameter have been removed in WCF 8. These APIs were previously used in .NET Framework to load client configuration parameters such as the `Binding` configuration and the `EndpointAddress` details. - -## Version introduced - -WCF Client 8.0 GA - -## Previous behavior - -The removed APIs were previously suppressed from IntelliSense suggestions, however, projects that used them compiled successfully. Using any of the removed APIs resulted in a at run time. - -## New behavior - -The [affected APIs](#affected-apis) no longer exist. If you upgrade to WCF 8 and recompile your project, it will fail. - -## Type of breaking change - -This change can affect [source compatibility](../../categories.md#source-compatibility). - -## Reason for change - -The [affected APIs](#affected-apis) were never implemented on .NET, and any calls to these APIs previously resulted in a run-time exception. Thus the decision was made to remove them completely. - -## Recommended action - -Remove any usage of the [affected APIs](#affected-apis). - -If you're using a WCF client generated by the `svcutil` utility from the .NET Framework SDK, the generated client will have constructors that call base class constructors that have been removed. The base class will be either or . The generated constructors were unusable on .NET as they resulted in a `PlatformNotSupportedException` being thrown. - -- If you're multi-targeting .NET Framework and .NET and are still using these generated constructors on .NET Framework, you'll need to conditionally compile their usage. -- If you're not using these constructors, you can delete them from the generated code. Alternatively, consider regenerating the client using `dotnet-svcutil`. - -## Affected APIs - -- -- -- -- -- -- -- -- -- -- -- diff --git a/docs/core/compatibility/wpf.md b/docs/core/compatibility/wpf.md deleted file mode 100644 index 125ff62816afb..0000000000000 --- a/docs/core/compatibility/wpf.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Windows Presentation Foundation for .NET Core 3.0 -description: Lists the breaking changes in Windows Presentation Foundation for .NET Core 3.0 -ms.date: 11/05/2024 ---- -# Breaking changes in Windows Presentation Foundation for .NET Core 3.0 - -Windows Forms support was added to .NET Core in version 3.0. This article lists breaking changes for Windows Forms by the .NET version in which they were introduced. If you're upgrading a Windows Forms app from .NET Framework or from a previous version of .NET Core (3.0 or later), this article applies to you. - -The following breaking changes are documented on this page: - -| Breaking change | Version introduced | -| - | :-: | -| [Altered drag-and-drop behavior on text editors](#altered-drag-and-drop-behavior-on-text-editors) | 3.0 | - -## .NET Core 3.0 - -[!INCLUDE[Default value of HttpRequestMessage.Version changed to 1.1](~/includes/core-changes/wpf/3.0/drag-and-drop.md)] - -*** From 595f9422e63c3681ff7cab3c2f29337480f7738b Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Tue, 1 Jul 2025 13:15:01 +0200 Subject: [PATCH 2/5] re-add wcf client breaks to toc --- docs/core/compatibility/2.1.md | 2 +- docs/core/compatibility/3.0.md | 2 +- docs/core/compatibility/3.1.md | 2 +- docs/core/compatibility/toc.yml | 12 +++++ .../6.0/duplex-synchronization-context.md | 38 +++++++++++++ .../wcf-client/6.0/net-standard-2-support.md | 40 ++++++++++++++ .../wcf-client/8.0/configurationname-apis.md | 54 +++++++++++++++++++ 7 files changed, 147 insertions(+), 3 deletions(-) create mode 100644 docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md create mode 100644 docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md create mode 100644 docs/core/compatibility/wcf-client/8.0/configurationname-apis.md diff --git a/docs/core/compatibility/2.1.md b/docs/core/compatibility/2.1.md index 75ad13ede4477..3b624f0e4ce71 100644 --- a/docs/core/compatibility/2.1.md +++ b/docs/core/compatibility/2.1.md @@ -5,7 +5,7 @@ ms.date: 02/19/2020 --- # Breaking changes in .NET Core 2.1 -If you're migrating to version 2.1 of .NET Core, the breaking changes listed in this article may affect your app. +If you're migrating to version 2.1 of .NET Core, the breaking changes listed in this article might affect your app. ## Core .NET libraries diff --git a/docs/core/compatibility/3.0.md b/docs/core/compatibility/3.0.md index 3a6b0dc468dec..b3abbd5762094 100644 --- a/docs/core/compatibility/3.0.md +++ b/docs/core/compatibility/3.0.md @@ -6,7 +6,7 @@ ms.custom: linux-related-content --- # Breaking changes in .NET Core 3.0 -If you're migrating to version 3.0 of .NET Core, ASP.NET Core, or EF Core, the breaking changes listed in this article may affect your app. +If you're migrating to version 3.0 of .NET Core, ASP.NET Core, or EF Core, the breaking changes listed in this article might affect your app. ## ASP.NET Core diff --git a/docs/core/compatibility/3.1.md b/docs/core/compatibility/3.1.md index c0e3c0729ba7a..b7db89a4840c0 100644 --- a/docs/core/compatibility/3.1.md +++ b/docs/core/compatibility/3.1.md @@ -5,7 +5,7 @@ ms.date: 07/28/2023 --- # Breaking changes in .NET Core 3.1 -If you're migrating to version 3.1 of .NET Core or ASP.NET Core, the breaking changes listed in this article may affect your app. +If you're migrating to version 3.1 of .NET Core or ASP.NET Core, the breaking changes listed in this article might affect your app. ## ASP.NET Core diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml index 38d60b7123bb7..9b14f0c460bb2 100644 --- a/docs/core/compatibility/toc.yml +++ b/docs/core/compatibility/toc.yml @@ -1156,6 +1156,18 @@ items: href: 3.0.md - name: .NET Core 2.1 href: 2.1.md + - name: WCF Client breaking changes + items: + - name: "Version 8.0" + items: + - name: Removal of APIs with `configurationName` parameter + href: wcf-client/8.0/configurationname-apis.md + - name: "Version 6.0" + items: + - name: Duplex contract captures synchronization context + href: wcf-client/6.0/duplex-synchronization-context.md + - name: No .NET Standard support + href: wcf-client/6.0/net-standard-2-support.md - name: Resources expanded: true items: diff --git a/docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md b/docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md new file mode 100644 index 0000000000000..a371b5297a1dc --- /dev/null +++ b/docs/core/compatibility/wcf-client/6.0/duplex-synchronization-context.md @@ -0,0 +1,38 @@ +--- +title: "Breaking change: DuplexChannelFactory captures synchronization context" +description: Learn about the breaking change in WCF Client 6.0 where the DuplexChannelFactory now captures the synchronization context when it's opened. +ms.date: 04/06/2023 +--- +# Duplex contract captures synchronization context + + now captures the synchronization context when it's opened, and it dispatches callbacks to the captured context. + +## Previous behavior + +In previous versions, failed to capture the current synchronization context when the channel factory was opened. + +## New behavior + +Starting in WCF Client 6.0 RC, captures the current synchronization context when opened and dispatches callbacks to the captured context. This behavior matches that of .NET Framework. + +## Version introduced + +WCF Client 6.0 RC + +## Type of breaking change + +This change is a [behavioral change](../../categories.md#behavioral-change). + +## Reason for change + +This change was made to fix a bug where callbacks were happening on the wrong thread. The new behavior matches .NET Framework functionality. + +## Recommended action + +If the new behavior is undesirable, you can revert to version 4.x behavior by applying the to your callback contract with the property set to `false`. + +## Affected APIs + +- [DuplexChannelFactory\.Open](xref:System.ServiceModel.Channels.CommunicationObject.Open) +- [DuplexChannelFactory\.BeginOpen](xref:System.ServiceModel.Channels.CommunicationObject.BeginOpen%2A) +- [DuplexChannelFactory\.EndOpen](xref:System.ServiceModel.Channels.CommunicationObject.EndOpen%2A) diff --git a/docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md b/docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md new file mode 100644 index 0000000000000..3bbab85dfa84c --- /dev/null +++ b/docs/core/compatibility/wcf-client/6.0/net-standard-2-support.md @@ -0,0 +1,40 @@ +--- +title: "Breaking change: WCF Client support for .NET Standard" +description: Learn about the breaking change in WCF Client 6.0 where it no longer supports .NET Standard 2.0. +ms.date: 01/17/2023 +--- +# WCF Client doesn't support .NET Standard + +The WCF Client 6.0 library targets .NET 6 and no longer supports .NET Standard 2.0. + +## Previous behavior + +Previously, you could add package references to WCF Client NuGet packages regardless of your project's target framework. For projects that targeted .NET Framework, WCF Client always used the *System.ServiceModel.dll* implementation in .NET Framework. + +## New behavior + +WCF Client packages target only .NET 6. Library projects that target .NET Standard 2.0 and reference WCF Client packages will now need to multi-target .NET Framework and .NET. + +In addition, the `System.ServiceModel.Duplex` and `System.ServiceModel.Security` packages are deprecated, and this is their last release. The types they contain have been moved to the [System.ServiceModel.Primitives package](https://www.nuget.org/packages/System.ServiceModel.Primitives). For binary compatibility, the final versions of the `System.ServiceModel.Duplex` and `System.ServiceModel.Security` packages forward their types to `System.ServiceModel.Primitives`. + +## Version introduced + +WCF Client 6.0 Preview 1 + +## Type of breaking change + +This change can affect [binary compatibility](../../categories.md#binary-compatibility). + +## Reason for change + +WCF Client releases previously targeted .NET Standard 2.0 to support both .NET (Core) and .NET Framework. This support helped developers modernize and migrate their existing WCF apps from .NET Framework to .NET. The change to remove support for .NET Standard was made so that WCF Client and WCF Client apps can take advantage of the new features and APIs available in .NET 6 and later versions. In addition, removing .NET Standard support reduces the size of the WCF Client NuGet packages, so the footprint is smaller during deployment. + +## Recommended action + +- If your WCF project targets .NET 6 or later, no change is needed. If it targets .NET Standard 2.0, you'll need to multi-target your WCF libraries. Add a conditional assembly reference to *System.ServiceModel.dll* for .NET Framework and conditionally add package references to WCF Client packages for .NET. + +- Remove references to the [System.ServiceModel.Duplex](https://www.nuget.org/packages/System.ServiceModel.Duplex) and [System.ServiceModel.Security](https://www.nuget.org/packages/System.ServiceModel.Security) packages, because they're no longer needed. + +## Affected APIs + +N/A diff --git a/docs/core/compatibility/wcf-client/8.0/configurationname-apis.md b/docs/core/compatibility/wcf-client/8.0/configurationname-apis.md new file mode 100644 index 0000000000000..3a7b5ca5eaa5a --- /dev/null +++ b/docs/core/compatibility/wcf-client/8.0/configurationname-apis.md @@ -0,0 +1,54 @@ +--- +title: "Removal of WCF APIs with a `configurationName` parameter" +description: Learn about the breaking change in WCF 8 where the APIs that accept a `configurationName` parameter have been removed. +ms.date: 11/13/2024 +ai-usage: ai-assisted +ms.custom: https://github.com/dotnet/docs/issues/43111 +--- + +# Removal of WCF APIs with a `configurationName` parameter + +The WCF APIs that accept either a `configurationName` parameter or an `endpointConfigurationName` parameter have been removed in WCF 8. These APIs were previously used in .NET Framework to load client configuration parameters such as the `Binding` configuration and the `EndpointAddress` details. + +## Version introduced + +WCF Client 8.0 GA + +## Previous behavior + +The removed APIs were previously suppressed from IntelliSense suggestions, however, projects that used them compiled successfully. Using any of the removed APIs resulted in a at run time. + +## New behavior + +The [affected APIs](#affected-apis) no longer exist. If you upgrade to WCF 8 and recompile your project, it will fail. + +## Type of breaking change + +This change can affect [source compatibility](../../categories.md#source-compatibility). + +## Reason for change + +The [affected APIs](#affected-apis) were never implemented on .NET, and any calls to these APIs previously resulted in a run-time exception. Thus the decision was made to remove them completely. + +## Recommended action + +Remove any usage of the [affected APIs](#affected-apis). + +If you're using a WCF client generated by the `svcutil` utility from the .NET Framework SDK, the generated client will have constructors that call base class constructors that have been removed. The base class will be either or . The generated constructors were unusable on .NET as they resulted in a `PlatformNotSupportedException` being thrown. + +- If you're multi-targeting .NET Framework and .NET and are still using these generated constructors on .NET Framework, you'll need to conditionally compile their usage. +- If you're not using these constructors, you can delete them from the generated code. Alternatively, consider regenerating the client using `dotnet-svcutil`. + +## Affected APIs + +- +- +- +- +- +- +- +- +- +- +- From bfce18582f7a4d137ee79c4fd776688c70b7dff6 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Tue, 1 Jul 2025 13:20:01 +0200 Subject: [PATCH 3/5] add redirects --- .openpublishing.redirection.core.json | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json index b1729d00bc400..1623e07f475f5 100644 --- a/.openpublishing.redirection.core.json +++ b/.openpublishing.redirection.core.json @@ -65,6 +65,10 @@ "source_path_from_root": "/docs/core/compatibility/aspnet-core/7.0/iendpointmetadataprovider-changes.md", "redirect_url": "/dotnet/core/compatibility/7.0" }, + { + "source_path_from_root": "/docs/core/compatibility/aspnetcore.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/code-analysis.md", "redirect_url": "/dotnet/core/compatibility/code-analysis/5.0/ca1416-platform-compatibility-analyzer" @@ -109,6 +113,10 @@ "source_path_from_root": "/docs/core/compatibility/core-libraries/8.0/optimizeforreading-arg.md", "redirect_url": "/dotnet/core/compatibility/8.0" }, + { + "source_path_from_root": "/docs/core/compatibility/cryptography.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/deployment/9.0/assembly-load-directory.md", "redirect_url": "/dotnet/core/compatibility/9.0" @@ -121,6 +129,10 @@ "source_path_from_root": "/docs/core/compatibility/framework-core.md", "redirect_url": "/dotnet/core/compatibility/fx-core" }, + { + "source_path_from_root": "/docs/core/compatibility/globalization.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/index.md", "redirect_url": "/dotnet/core/compatibility/library-change-rules", @@ -155,6 +167,10 @@ "redirect_url": "/dotnet/core/compatibility/sdk/6.0/gettargetframeworkproperties-and-getnearesttargetframework-removed", "redirect_document_id": true }, + { + "source_path_from_root": "/docs/core/compatibility/networking.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/networking/7.0/connectasync-argumentexception.md", "redirect_url": "/dotnet/core/compatibility/7.0" @@ -346,6 +362,10 @@ "source_path_from_root": "/docs/core/compatibility/windows-forms/8.0/anchor-layout.md", "redirect_url": "/dotnet/core/compatibility/8.0" }, + { + "source_path_from_root": "/docs/core/compatibility/wpf.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/deploying/applications.md", "redirect_url": "/dotnet/core/deploying/index" From 412f984bfc8de355342ec99bdbdac86bffd7976f Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Tue, 1 Jul 2025 14:10:17 +0200 Subject: [PATCH 4/5] delete more orphaned files and add redirects --- .openpublishing.redirection.core.json | 16 +++ docs/core/compatibility/corefx.md | 109 ------------------ docs/core/compatibility/globalization.md | 18 --- docs/core/compatibility/msbuild.md | 32 ----- docs/core/compatibility/winforms.md | 91 --------------- docs/core/resources/manifest-file-names.md | 1 - .../string-comparison-net-5-plus.md | 58 +++++----- docs/standard/glossary.md | 2 +- 8 files changed, 46 insertions(+), 281 deletions(-) delete mode 100644 docs/core/compatibility/corefx.md delete mode 100644 docs/core/compatibility/globalization.md delete mode 100644 docs/core/compatibility/msbuild.md delete mode 100644 docs/core/compatibility/winforms.md diff --git a/.openpublishing.redirection.core.json b/.openpublishing.redirection.core.json index 1623e07f475f5..f2867967dd53f 100644 --- a/.openpublishing.redirection.core.json +++ b/.openpublishing.redirection.core.json @@ -113,6 +113,10 @@ "source_path_from_root": "/docs/core/compatibility/core-libraries/8.0/optimizeforreading-arg.md", "redirect_url": "/dotnet/core/compatibility/8.0" }, + { + "source_path_from_root": "/docs/core/compatibility/corefx.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/cryptography.md", "redirect_url": "/dotnet/core/compatibility/3.0" @@ -142,6 +146,10 @@ "source_path_from_root": "/docs/core/compatibility/interop.md", "redirect_url": "/dotnet/core/compatibility/interop/5.0/built-in-support-for-winrt-removed" }, + { + "source_path_from_root": "/docs/core/compatibility/msbuild.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/msbuild/5.0/directory-packages-props-imported-by-default.md", "redirect_url": "/dotnet/core/compatibility/sdk/5.0/directory-packages-props-imported-by-default", @@ -348,6 +356,10 @@ "source_path_from_root": "/docs/core/compatibility/syslib0012.md", "redirect_url": "/dotnet/fundamentals/syslib-diagnostics/syslib0012" }, + { + "source_path_from_root": "/docs/core/compatibility/visualbasic.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/windows-forms/5.0/automatically-infer-winexe-output-type.md", "redirect_url": "/dotnet/core/compatibility/sdk/5.0/automatically-infer-winexe-output-type", @@ -362,6 +374,10 @@ "source_path_from_root": "/docs/core/compatibility/windows-forms/8.0/anchor-layout.md", "redirect_url": "/dotnet/core/compatibility/8.0" }, + { + "source_path_from_root": "/docs/core/compatibility/winforms.md", + "redirect_url": "/dotnet/core/compatibility/3.0" + }, { "source_path_from_root": "/docs/core/compatibility/wpf.md", "redirect_url": "/dotnet/core/compatibility/3.0" diff --git a/docs/core/compatibility/corefx.md b/docs/core/compatibility/corefx.md deleted file mode 100644 index 4e21fb5378195..0000000000000 --- a/docs/core/compatibility/corefx.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: .NET library breaking changes -description: Lists the breaking changes in core .NET libraries for .NET Core versions 1.0-3.0. -ms.date: 07/27/2020 ---- -# Core .NET libraries breaking changes in .NET Core 1.0-3.0 - -The core .NET libraries provide the primitives and other general types used by .NET Core. - -The following breaking changes are documented on this page: - -| Breaking change | Version introduced | -| - | :-: | -| [Passing GroupCollection to extension methods taking IEnumerable\ requires disambiguation](#passing-groupcollection-to-extension-methods-taking-ienumerablet-requires-disambiguation) | .NET Core 3.0 | -| [APIs that report version now report product and not file version](#apis-that-report-version-now-report-product-and-not-file-version) | .NET Core 3.0 | -| [Custom EncoderFallbackBuffer instances cannot fall back recursively](#custom-encoderfallbackbuffer-instances-cannot-fall-back-recursively) | .NET Core 3.0 | -| [Floating point formatting and parsing behavior changes](#floating-point-formatting-and-parsing-behavior-changed) | .NET Core 3.0 | -| [Floating-point parsing operations no longer fail or throw an OverflowException](#floating-point-parsing-operations-no-longer-fail-or-throw-an-overflowexception) | .NET Core 3.0 | -| [InvalidAsynchronousStateException moved to another assembly](#invalidasynchronousstateexception-moved-to-another-assembly) | .NET Core 3.0 | -| [Replacing ill-formed UTF-8 byte sequences follows Unicode guidelines](#replacing-ill-formed-utf-8-byte-sequences-follows-unicode-guidelines) | .NET Core 3.0 | -| [TypeDescriptionProviderAttribute moved to another assembly](#typedescriptionproviderattribute-moved-to-another-assembly) | .NET Core 3.0 | -| [ZipArchiveEntry no longer handles archives with inconsistent entry sizes](#ziparchiveentry-no-longer-handles-archives-with-inconsistent-entry-sizes) | .NET Core 3.0 | -| [FieldInfo.SetValue throws exception for static, init-only fields](#fieldinfosetvalue-throws-exception-for-static-init-only-fields) | .NET Core 3.0 | -| [Path APIs don't throw an exception for invalid characters](#path-apis-dont-throw-an-exception-for-invalid-characters) | .NET Core 2.1 | -| [Private fields added to built-in struct types](#private-fields-added-to-built-in-struct-types) | .NET Core 2.1 | -| [Change in default value of UseShellExecute](#change-in-default-value-of-useshellexecute) | .NET Core 2.1 | -| [OpenSSL versions on macOS](#openssl-versions-on-macos) | .NET Core 2.1 | -| [UnauthorizedAccessException thrown by FileSystemInfo.Attributes](#unauthorizedaccessexception-thrown-by-filesysteminfoattributes) | .NET Core 1.0 | -| [Handling corrupted-process-state exceptions is not supported](#handling-corrupted-state-exceptions-is-not-supported) | .NET Core 1.0 | -| [UriBuilder properties no longer prepend leading characters](#uribuilder-properties-no-longer-prepend-leading-characters) | .NET Core 1.0 | -| [Process.StartInfo throws InvalidOperationException for processes you didn't start](#processstartinfo-throws-invalidoperationexception-for-processes-you-didnt-start) | .NET Core 1.0 | - -## .NET Core 3.0 - -[!INCLUDE [disambiguate-generic-type-for-groupcollection](../../../includes/core-changes/corefx/3.0/disambiguate-generic-type-for-groupcollection.md)] - -*** - -[!INCLUDE[APIs that report version now report product and not file version](~/includes/core-changes/corefx/3.0/version-information-changes.md)] - -*** - -[!INCLUDE[Custom EncoderFallbackBuffer instances cannot fall back recursively](~/includes/core-changes/corefx/3.0/custom-encoderfallbackbuffer-cannot-be-recursive.md)] - -*** - -[!INCLUDE[Floating point formatting and parsing behavior changes](~/includes/core-changes/corefx/3.0/floating-point-changes.md)] - -*** - -[!INCLUDE[Floating-point parsing operations no longer fail or throw an OverflowException](~/includes/core-changes/corefx/3.0/floating-point-parsing-does-not-overflow.md)] - -*** - -[!INCLUDE[InvalidAsynchronousStateException moved to another assembly](~/includes/core-changes/corefx/3.0/move-invalidasynchronousstateexception.md)] - -*** - -[!INCLUDE[NET Core 3.0 follows Unicode best practices when replacing ill-formed UTF-8 byte sequences](~/includes/core-changes/corefx/3.0/net-core-3-0-follows-unicode-utf8-best-practices.md)] - -*** - -[!INCLUDE[TypeDescriptionProviderAttribute moved to another assembly](~/includes/core-changes/corefx/3.0/move-typedescriptionproviderattribute.md)] - -*** - -[!INCLUDE[ZipArchiveEntry no longer handles archives with inconsistent entry sizes](~/includes/core-changes/corefx/3.0/ziparchiveentry-and-inconsistent-entry-sizes.md)] - -*** - -[!INCLUDE [FieldInfo.SetValue throws exception for static, init-only fields](~/includes/core-changes/corefx/3.0/fieldinfo-setvalue-exception.md)] - -*** - -## .NET Core 2.1 - -[!INCLUDE [path-apis-dont-throw-exception-for-invalid-paths](../../../includes/core-changes/corefx/2.1/path-apis-dont-throw-exception-for-invalid-paths.md)] - -*** - -[!INCLUDE[Private fields added to built-in struct types](~/includes/core-changes/corefx/2.1/instantiate-struct.md)] - -*** - -[!INCLUDE[Change in default value of UseShellExecute](~/includes/core-changes/corefx/2.1/process-start-changes.md)] - -*** - -[!INCLUDE [OpenSSL versions on macOS](../../../includes/core-changes/corefx/openssl-dependencies-macos.md)] - -*** - -## .NET Core 1.0 - -[!INCLUDE [UnauthorizedAccessException thrown by FileSystemInfo.Attributes](~/includes/core-changes/corefx/1.0/filesysteminfo-attributes-exceptions.md)] - -*** - -[!INCLUDE [corrupted-state-exceptions](~/includes/core-changes/corefx/1.0/corrupted-state-exceptions.md)] - -*** - -[!INCLUDE [uribuilder-behavior-changes](../../../includes/core-changes/corefx/1.0/uribuilder-behavior-changes.md)] - -*** - -[!INCLUDE [startinfo-throws-exception](../../../includes/core-changes/corefx/1.0/startinfo-throws-exception.md)] - -*** diff --git a/docs/core/compatibility/globalization.md b/docs/core/compatibility/globalization.md deleted file mode 100644 index 56e354d1d4415..0000000000000 --- a/docs/core/compatibility/globalization.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Globalization breaking changes -description: Lists the breaking changes in globalization in .NET Core 3.0. -ms.date: 04/07/2020 ---- -# Globalization breaking changes in .NET Core 3.0 - -The following breaking changes are documented on this page: - -| Breaking change | Version introduced | -| - | :-: | -| ["C" locale maps to the invariant locale](#c-locale-maps-to-the-invariant-locale) | 3.0 | - -## .NET Core 3.0 - -[!INCLUDE["C" locale maps to the invariant locale](~/includes/core-changes/globalization/3.0/c-locale-maps-to-invariant-locale.md)] - -*** diff --git a/docs/core/compatibility/msbuild.md b/docs/core/compatibility/msbuild.md deleted file mode 100644 index 1de22f4c234e6..0000000000000 --- a/docs/core/compatibility/msbuild.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: MSBuild breaking changes -description: Lists the breaking changes in MSBuild for .NET Core 2.1 - 3.1. -ms.date: 02/22/2021 ---- -# MSBuild breaking changes in .NET Core 2.1 - 3.1 - -The following breaking changes are documented on this page: - -| Breaking change | Version introduced | -| - | - | -| [Design-time builds only return top-level package references](#design-time-builds-only-return-top-level-package-references) | 3.1 | -| [Resource manifest file name change](#resource-manifest-file-name-change) | 3.0 | -| [Project tools now included in SDK](#project-tools-now-included-in-sdk) | 2.1 | - -## .NET Core 3.1 - -[!INCLUDE [design-time-builds-return-top-level-package-refs](../../../includes/core-changes/msbuild/3.1/design-time-builds-return-top-level-package-refs.md)] - -*** - -## .NET Core 3.0 - -[!INCLUDE[Resource file names](../../../includes/core-changes/msbuild/3.0/resource-manifest-name.md)] - -*** - -## .NET Core 2.1 - -[!INCLUDE [DotNetCliToolReference project elements removed for bundled tools](../../../includes/core-changes/msbuild/2.1/dotnetclitoolreference.md)] - -*** diff --git a/docs/core/compatibility/winforms.md b/docs/core/compatibility/winforms.md deleted file mode 100644 index 7c8806e77764d..0000000000000 --- a/docs/core/compatibility/winforms.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Windows Forms breaking changes -description: Lists the breaking changes in Windows Forms for .NET Core 3.0 and 3.1. -ms.date: 09/08/2020 ---- -# Breaking changes in Windows Forms for .NET Core 3.0 and 3.1 - -Windows Forms support was added to .NET Core in version 3.0. This article lists breaking changes for Windows Forms by the .NET version in which they were introduced. If you're upgrading a Windows Forms app from .NET Framework or from a previous version of .NET Core (3.0 or later), this article applies to you. - -The following breaking changes are documented on this page: - -| Breaking change | Version introduced | -| - | :-: | -| [Removed controls](#removed-controls) | 3.1 | -| [CellFormatting event not raised if tooltip is shown](#cellformatting-event-not-raised-if-tooltip-is-shown) | 3.1 | -| [Control.DefaultFont changed to Segoe UI 9 pt](#default-control-font-changed-to-segoe-ui-9-pt) | 3.0 | -| [Modernization of the FolderBrowserDialog](#modernization-of-the-folderbrowserdialog) | 3.0 | -| [SerializableAttribute removed from some Windows Forms types](#serializableattribute-removed-from-some-windows-forms-types) | 3.0 | -| [AllowUpdateChildControlIndexForTabControls compatibility switch not supported](#allowupdatechildcontrolindexfortabcontrols-compatibility-switch-not-supported) | 3.0 | -| [DomainUpDown.UseLegacyScrolling compatibility switch not supported](#domainupdownuselegacyscrolling-compatibility-switch-not-supported) | 3.0 | -| [DoNotLoadLatestRichEditControl compatibility switch not supported](#donotloadlatestricheditcontrol-compatibility-switch-not-supported) | 3.0 | -| [DoNotSupportSelectAllShortcutInMultilineTextBox compatibility switch not supported](#donotsupportselectallshortcutinmultilinetextbox-compatibility-switch-not-supported) | 3.0 | -| [DontSupportReentrantFilterMessage compatibility switch not supported](#dontsupportreentrantfiltermessage-compatibility-switch-not-supported) | 3.0 | -| [EnableVisualStyleValidation compatibility switch not supported](#enablevisualstylevalidation-compatibility-switch-not-supported) | 3.0 | -| [UseLegacyContextMenuStripSourceControlValue compatibility switch not supported](#uselegacycontextmenustripsourcecontrolvalue-compatibility-switch-not-supported) | 3.0 | -| [UseLegacyImages compatibility switch not supported](#uselegacyimages-compatibility-switch-not-supported) | 3.0 | -| [About and SplashScreen templates are broken for Visual Basic](#about-and-splashscreen-templates-are-broken) | 3.0 | - -## .NET Core 3.1 - -[!INCLUDE[Removed controls](~/includes/core-changes/windowsforms/3.1/remove-controls-3.1.md)] - -*** - -[!INCLUDE[CellFormatting event](~/includes/core-changes/windowsforms/3.1/cellformatting-event-not-raised.md)] - -*** - -## .NET Core 3.0 - -[!INCLUDE[Control.DefaultFont changed to Segoe UI 9pt](~/includes/core-changes/windowsforms/3.0/control-defaultfont-changed.md)] - -*** - -[!INCLUDE[Modernization of the FolderBrowserDialog](~/includes/core-changes/windowsforms/3.0/modernized-folderbrowserdialog.md)] - -*** - -[!INCLUDE[SerializableAttribute removed from some Windows Forms types](~/includes/core-changes/windowsforms/3.0/remove-serializationattribute.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-allowupdatechildcontrolindexfortabcontrols.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-uselegacyscrolling.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.DoNotLoadLatestRichEditControl compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-donotloadlatestricheditcontrol.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.DoNotSupportSelectAllShortcutInMultilineTextBox compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-donotsupportselectallshortcutinmultilinetextbox.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.DontSupportReentrantFilterMessage compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-dontsupportreentrantfiltermessage.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.EnableVisualStyleValidation compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-enablevisualstylevalidation.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.UseLegacyContextMenuStripSourceControlValue compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-uselegacycontextmenustripsourcecontrolvalue.md)] - -*** - -[!INCLUDE[Switch.System.Windows.Forms.UseLegacyImages compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-uselegacyimages.md)] - -*** - -[!INCLUDE[About and SplashScreen templates are broken for Visual Basic](~/includes/core-changes/visualbasic/3.0/vb-winforms-splash-about-broken.md)] - -*** - -## See also - -- [Port a Windows Forms app to .NET Core](/dotnet/desktop/winforms/migration/) diff --git a/docs/core/resources/manifest-file-names.md b/docs/core/resources/manifest-file-names.md index 98df3138b523a..c50593b8dd47c 100644 --- a/docs/core/resources/manifest-file-names.md +++ b/docs/core/resources/manifest-file-names.md @@ -97,4 +97,3 @@ If `EmbeddedResourceUseDependentUponConvention` is set to `false` in the project - [How Manifest Resource Naming Works](https://gist.github.com/BenVillalobos/041673b9a73bec60fdc3bf0f86fae62a) - [MSBuild properties for .NET SDK projects](../project-sdk/msbuild-props.md) -- [MSBuild breaking changes](../compatibility/msbuild.md) diff --git a/docs/standard/base-types/string-comparison-net-5-plus.md b/docs/standard/base-types/string-comparison-net-5-plus.md index 31d2c834b06ae..5ea0b746a766f 100644 --- a/docs/standard/base-types/string-comparison-net-5-plus.md +++ b/docs/standard/base-types/string-comparison-net-5-plus.md @@ -273,34 +273,34 @@ Because the `string.IndexOf(string)` method uses a linguistic search by default, The following table lists the default search and comparison types for various string and string-like APIs. If the caller provides an explicit `CultureInfo` or `StringComparison` parameter, that parameter will be honored over any default. -| API | Default behavior | Remarks | -|---|---|---| -| `string.Compare` | CurrentCulture | | -| `string.CompareTo` | CurrentCulture | | -| `string.Contains` | Ordinal | | -| `string.EndsWith` | Ordinal | (when the first parameter is a `char`) | -| `string.EndsWith` | CurrentCulture | (when the first parameter is a `string`) | -| `string.Equals` | Ordinal | | -| `string.GetHashCode` | Ordinal | | -| `string.IndexOf` | Ordinal | (when the first parameter is a `char`) | -| `string.IndexOf` | CurrentCulture | (when the first parameter is a `string`) | -| `string.IndexOfAny` | Ordinal | | -| `string.LastIndexOf` | Ordinal | (when the first parameter is a `char`) | -| `string.LastIndexOf` | CurrentCulture | (when the first parameter is a `string`) | -| `string.LastIndexOfAny` | Ordinal | | -| `string.Replace` | Ordinal | | -| `string.Split` | Ordinal | | -| `string.StartsWith` | Ordinal | (when the first parameter is a `char`) | -| `string.StartsWith` | CurrentCulture | (when the first parameter is a `string`) | -| `string.ToLower` | CurrentCulture | | -| `string.ToLowerInvariant` | InvariantCulture | | -| `string.ToUpper` | CurrentCulture | | -| `string.ToUpperInvariant` | InvariantCulture | | -| `string.Trim` | Ordinal | | -| `string.TrimEnd` | Ordinal | | -| `string.TrimStart` | Ordinal | | -| `string == string` | Ordinal | | -| `string != string` | Ordinal | | +| API | Default behavior | Remarks | +|---------------------------|------------------|------------------------------------------| +| `string.Compare` | CurrentCulture | | +| `string.CompareTo` | CurrentCulture | | +| `string.Contains` | Ordinal | | +| `string.EndsWith` | Ordinal | (when the first parameter is a `char`) | +| `string.EndsWith` | CurrentCulture | (when the first parameter is a `string`) | +| `string.Equals` | Ordinal | | +| `string.GetHashCode` | Ordinal | | +| `string.IndexOf` | Ordinal | (when the first parameter is a `char`) | +| `string.IndexOf` | CurrentCulture | (when the first parameter is a `string`) | +| `string.IndexOfAny` | Ordinal | | +| `string.LastIndexOf` | Ordinal | (when the first parameter is a `char`) | +| `string.LastIndexOf` | CurrentCulture | (when the first parameter is a `string`) | +| `string.LastIndexOfAny` | Ordinal | | +| `string.Replace` | Ordinal | | +| `string.Split` | Ordinal | | +| `string.StartsWith` | Ordinal | (when the first parameter is a `char`) | +| `string.StartsWith` | CurrentCulture | (when the first parameter is a `string`) | +| `string.ToLower` | CurrentCulture | | +| `string.ToLowerInvariant` | InvariantCulture | | +| `string.ToUpper` | CurrentCulture | | +| `string.ToUpperInvariant` | InvariantCulture | | +| `string.Trim` | Ordinal | | +| `string.TrimEnd` | Ordinal | | +| `string.TrimStart` | Ordinal | | +| `string == string` | Ordinal | | +| `string != string` | Ordinal | | Unlike `string` APIs, all `MemoryExtensions` APIs perform *Ordinal* searches and comparisons by default, with the following exceptions. @@ -333,7 +333,7 @@ if (span.StartsWith("Hello", StringComparison.Ordinal)) { /* do something */ } / ## See also -- [Globalization breaking changes](../../core/compatibility/globalization.md) +- [Globalization breaking changes in .NET 5](../../core/compatibility/5.0.md#globalization) - [Best practices for comparing strings in .NET](best-practices-strings.md) - [How to compare strings in C#](../../csharp/how-to/compare-strings.md) - [.NET globalization and ICU](../../core/extensions/globalization-icu.md) diff --git a/docs/standard/glossary.md b/docs/standard/glossary.md index aaa534e3bae9d..d436268246d73 100644 --- a/docs/standard/glossary.md +++ b/docs/standard/glossary.md @@ -61,7 +61,7 @@ The source code of the BCL for [.NET](#net) is contained in the [.NET runtime re The following terms often refer to the same collection of APIs that BCL refers to: -- [core .NET libraries](../core/compatibility/corefx.md) +- core .NET libraries - [framework libraries](#framework-libraries) - [runtime libraries](#runtime) - [shared framework](#shared-framework) From 3dbfbf7a3b21badd54346e50cec7b87416ed2c8d Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Tue, 1 Jul 2025 14:18:43 +0200 Subject: [PATCH 5/5] fix broken links --- docs/core/compatibility/3.0.md | 63 +++++++++++++++++++ ...dview-doesnt-reset-custom-font-settings.md | 2 +- docs/core/whats-new/dotnet-core-3-0.md | 2 +- docs/core/whats-new/dotnet-core-3-1.md | 2 +- 4 files changed, 66 insertions(+), 3 deletions(-) diff --git a/docs/core/compatibility/3.0.md b/docs/core/compatibility/3.0.md index b3abbd5762094..ed51dac352324 100644 --- a/docs/core/compatibility/3.0.md +++ b/docs/core/compatibility/3.0.md @@ -380,6 +380,69 @@ If you're migrating to version 3.0 of .NET Core, ASP.NET Core, or EF Core, the b *** +## Windows Forms + +- [Control.DefaultFont changed to Segoe UI 9 pt](#default-control-font-changed-to-segoe-ui-9-pt) +- [Modernization of the FolderBrowserDialog](#modernization-of-the-folderbrowserdialog) +- [SerializableAttribute removed from some Windows Forms types](#serializableattribute-removed-from-some-windows-forms-types) +- [AllowUpdateChildControlIndexForTabControls compatibility switch not supported](#allowupdatechildcontrolindexfortabcontrols-compatibility-switch-not-supported) +- [DomainUpDown.UseLegacyScrolling compatibility switch not supported](#domainupdownuselegacyscrolling-compatibility-switch-not-supported) +- [DoNotLoadLatestRichEditControl compatibility switch not supported](#donotloadlatestricheditcontrol-compatibility-switch-not-supported) +- [DoNotSupportSelectAllShortcutInMultilineTextBox compatibility switch not supported](#donotsupportselectallshortcutinmultilinetextbox-compatibility-switch-not-supported) +- [DontSupportReentrantFilterMessage compatibility switch not supported](#dontsupportreentrantfiltermessage-compatibility-switch-not-supported) +- [EnableVisualStyleValidation compatibility switch not supported](#enablevisualstylevalidation-compatibility-switch-not-supported) +- [UseLegacyContextMenuStripSourceControlValue compatibility switch not supported](#uselegacycontextmenustripsourcecontrolvalue-compatibility-switch-not-supported) +- [UseLegacyImages compatibility switch not supported](#uselegacyimages-compatibility-switch-not-supported) +- [About and SplashScreen templates are broken for Visual Basic](#about-and-splashscreen-templates-are-broken) + +[!INCLUDE[Control.DefaultFont changed to Segoe UI 9pt](~/includes/core-changes/windowsforms/3.0/control-defaultfont-changed.md)] + +*** + +[!INCLUDE[Modernization of the FolderBrowserDialog](~/includes/core-changes/windowsforms/3.0/modernized-folderbrowserdialog.md)] + +*** + +[!INCLUDE[SerializableAttribute removed from some Windows Forms types](~/includes/core-changes/windowsforms/3.0/remove-serializationattribute.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-allowupdatechildcontrolindexfortabcontrols.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-uselegacyscrolling.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.DoNotLoadLatestRichEditControl compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-donotloadlatestricheditcontrol.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.DoNotSupportSelectAllShortcutInMultilineTextBox compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-donotsupportselectallshortcutinmultilinetextbox.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.DontSupportReentrantFilterMessage compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-dontsupportreentrantfiltermessage.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.EnableVisualStyleValidation compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-enablevisualstylevalidation.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.UseLegacyContextMenuStripSourceControlValue compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-uselegacycontextmenustripsourcecontrolvalue.md)] + +*** + +[!INCLUDE[Switch.System.Windows.Forms.UseLegacyImages compatibility switch not supported](~/includes/core-changes/windowsforms/3.0/deprecate-uselegacyimages.md)] + +*** + +[!INCLUDE[About and SplashScreen templates are broken for Visual Basic](~/includes/core-changes/visualbasic/3.0/vb-winforms-splash-about-broken.md)] + +*** + ## WPF - [Altered drag-and-drop behavior on text editors](#altered-drag-and-drop-behavior-on-text-editors) diff --git a/docs/core/compatibility/windows-forms/5.0/datagridview-doesnt-reset-custom-font-settings.md b/docs/core/compatibility/windows-forms/5.0/datagridview-doesnt-reset-custom-font-settings.md index e5e261a2d92e5..20f4945009923 100644 --- a/docs/core/compatibility/windows-forms/5.0/datagridview-doesnt-reset-custom-font-settings.md +++ b/docs/core/compatibility/windows-forms/5.0/datagridview-doesnt-reset-custom-font-settings.md @@ -15,7 +15,7 @@ Starting in .NET 5, if you configure font settings in the controls, and impeded the migration of these apps from .NET Framework to .NET 5.0. +With the [change of the default font in .NET Core 3.0](../../3.0.md#windows-forms), the default font settings for the various cell styles also changed. This behavior is undesirable for apps that rely on custom styling in their controls, and impeded the migration of these apps from .NET Framework to .NET 5.0. ## Version introduced diff --git a/docs/core/whats-new/dotnet-core-3-0.md b/docs/core/whats-new/dotnet-core-3-0.md index 6127c9ab8167b..88a14598d26de 100644 --- a/docs/core/whats-new/dotnet-core-3-0.md +++ b/docs/core/whats-new/dotnet-core-3-0.md @@ -560,4 +560,4 @@ Many times when you're developing an application, you want to use an unencrypted ## Next steps - [Review the breaking changes between .NET Core 2.2 and 3.0.](../compatibility/3.0.md) -- [Review the breaking changes in .NET Core 3.0 for Windows Forms apps.](../compatibility/winforms.md#net-core-30) +- [Review the breaking changes in .NET Core 3.0 for Windows Forms apps.](../compatibility/3.0.md#windows-forms) diff --git a/docs/core/whats-new/dotnet-core-3-1.md b/docs/core/whats-new/dotnet-core-3-1.md index b04f1bce6a11c..cffe958ce594f 100644 --- a/docs/core/whats-new/dotnet-core-3-1.md +++ b/docs/core/whats-new/dotnet-core-3-1.md @@ -94,4 +94,4 @@ To add support for C++/CLI in Visual Studio 2019 version 16.4, install the [Desk ## Next steps - [Review the breaking changes between .NET Core 3.0 and 3.1.](../compatibility/3.1.md) -- [Review the breaking changes in .NET Core 3.1 for Windows Forms apps.](../compatibility/winforms.md#net-core-31) +- [Review the breaking changes in .NET Core 3.1 for Windows Forms apps.](../compatibility/3.1.md#windows-forms)