dotnet · gewarren · Jun 6, 2025 · Jun 6, 2025 · Jun 6, 2025
@@ -1,4 +1,4 @@
-When you're assigned an issue that's labeled "breaking-change", or when you're given a link to an issue that's labeled "breaking-change" and asked to create a new breaking change document, follow the following guidelines:
+When you're assigned an issue that's labeled "breaking-change", or when you're given a link to an issue with this prompt file as context and asked to create a new breaking change document, follow these guidelines:
 
 The document should be in Markdown format.
 

@@ -2,7 +2,7 @@
 title: Breaking changes in .NET 10
 titleSuffix: ""
 description: Navigate to the breaking changes in .NET 10.
-ms.date: 04/21/2025
+ms.date: 06/05/2025
 ai-usage: ai-assisted
 no-loc: [Blazor, Razor, Kestrel]
 ---
@@ -18,78 +18,79 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af
 
 ## Containers
 
-| Title                                                                                                                      | Type of change      | Introduced version |
-|----------------------------------------------------------------------------------------------------------------------------|---------------------|--------------------|
-| [Default .NET images use Ubuntu](containers/10.0/default-images-use-ubuntu.md)                                             | Behavioral change   | Preview 1          |
+| Title                                                                          | Type of change    | Introduced version |
+|--------------------------------------------------------------------------------|-------------------|--------------------|
+| [Default .NET images use Ubuntu](containers/10.0/default-images-use-ubuntu.md) | Behavioral change | Preview 1          |
 
 ## Core .NET libraries
 
-| Title                                                                                                                      | Type of change      | Introduced version |
-|----------------------------------------------------------------------------------------------------------------------------|---------------------|--------------------|
-| [ActivitySource.CreateActivity and ActivitySource.StartActivity behavior change](core-libraries/10.0/activity-sampling.md) | Behavioral change   | Preview 1          |
-| [C# 14 overload resolution with span parameters](core-libraries/10.0/csharp-overload-resolution.md)                        | Behavioral change   | Preview 1          |
-| [Consistent shift behavior in generic math](core-libraries/10.0/generic-math.md)                                           | Behavioral change   | Preview 1          |
-| [Default trace context propagator updated to W3C standard](core-libraries/10.0/default-trace-context-propagator.md)        | Behavioral change   | Preview 4          |
-| [LDAP DirectoryControl parsing is now more stringent](core-libraries/10.0/ldap-directorycontrol-parsing.md)                | Behavioral change   | Preview 1          |
-| [MacCatalyst version normalization](core-libraries/10.0/maccatalyst-version-normalization.md)                              | Behavioral change   | Preview 1          |
-| [System.Linq.AsyncEnumerable included in core libraries](core-libraries/10.0/asyncenumerable.md)                           | Source incompatible | Preview 1          |
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [ActivitySource.CreateActivity and ActivitySource.StartActivity behavior change](core-libraries/10.0/activity-sampling.md) | Behavioral change | Preview 1 |
+| [C# 14 overload resolution with span parameters](core-libraries/10.0/csharp-overload-resolution.md) | Behavioral change | Preview 1 |
+| [Consistent shift behavior in generic math](core-libraries/10.0/generic-math.md) | Behavioral change | Preview 1 |
+| [Default trace context propagator updated to W3C standard](core-libraries/10.0/default-trace-context-propagator.md) | Behavioral change | Preview 4 |
+| [LDAP DirectoryControl parsing is now more stringent](core-libraries/10.0/ldap-directorycontrol-parsing.md) | Behavioral change | Preview 1 |
+| [MacCatalyst version normalization](core-libraries/10.0/maccatalyst-version-normalization.md) | Behavioral change | Preview 1 |
+| [System.Linq.AsyncEnumerable included in core libraries](core-libraries/10.0/asyncenumerable.md) | Source incompatible | Preview 1 |
 
 ## Extensions
 
-| Title                                                                                                     | Type of change      | Introduced version |
-|-----------------------------------------------------------------------------------------------------------|---------------------|--------------------|
-| [ProviderAliasAttribute moved to Microsoft.Extensions.Logging.Abstractions assembly](extensions/10.0/provideraliasattribute-moved-assembly.md) | Source incompatible | Preview 4          |
+| Title | Type of change      | Introduced version |
+|-------|---------------------|--------------------|
+| [ProviderAliasAttribute moved to Microsoft.Extensions.Logging.Abstractions assembly](extensions/10.0/provideraliasattribute-moved-assembly.md) | Source incompatible | Preview 4 |
 
 ## Globalization
 
-| Title                                                                                                 | Type of change    | Introduced version |
-|-------------------------------------------------------------------------------------------------------|-------------------|--------------------|
-| [Environment variable renamed to DOTNET_ICU_VERSION_OVERRIDE](globalization/10.0/version-override.md) | Behavioral change | Preview 1          |
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [Environment variable renamed to DOTNET_ICU_VERSION_OVERRIDE](globalization/10.0/version-override.md) | Behavioral change | Preview 1 |
 
 ## Cryptography
 
-| Title                                                                                                    | Type of change                        | Introduced version |
-|----------------------------------------------------------------------------------------------------------|---------------------------------------|--------------------|
-| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md)    | Behavioral change                     | Preview 1          |
-| [X509Certificate and PublicKey key parameters can be null](cryptography/10.0/x509-publickey-null.md)     | Behavioral/source incompatible change | Preview 3          |
-| [Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE](cryptography/10.0/version-override.md) | Behavioral change                     | Preview 1          |
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 |
+| [X509Certificate and PublicKey key parameters can be null](cryptography/10.0/x509-publickey-null.md) | Behavioral/source incompatible change | Preview 3 |
+| [Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE](cryptography/10.0/version-override.md) | Behavioral change | Preview 1 |
 
 ## Interop
 
-| Title                                                                                                                              | Type of change    | Introduced version |
-|------------------------------------------------------------------------------------------------------------------------------------|-------------------|--------------------|
-| [Specifying DllImportSearchPath.AssemblyDirectory only searches the assembly directory](interop/10.0/search-assembly-directory.md) | Behavioral change | Preview 5          |
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [Specifying DllImportSearchPath.AssemblyDirectory only searches the assembly directory](interop/10.0/search-assembly-directory.md) | Behavioral change | Preview 5 |
 
 ## Networking
 
-| Title                                                                                                            | Type of change    | Introduced version |
-|------------------------------------------------------------------------------------------------------------------|-------------------|--------------------|
-| [Streaming HTTP responses enabled by default in browser HTTP clients](networking/10.0/default-http-streaming.md) | Behavioral change | Preview 3          |
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [Streaming HTTP responses enabled by default in browser HTTP clients](networking/10.0/default-http-streaming.md) | Behavioral change | Preview 3 |
 
 ## SDK and MSBuild
 
-| Title                                                                                                                        | Type of change                        | Introduced version |
-|------------------------------------------------------------------------------------------------------------------------------|---------------------------------------|--------------------|
-| [.NET CLI `--interactive` defaults to `true` in user scenarios](sdk/10.0/dotnet-cli-interactive.md)                          | Behavioral change                     | Preview 3          |
-| [Default workload configuration from 'loose manifests' to 'workload sets' mode](sdk/10.0/default-workload-config.md)         | Behavioral change                     | Preview 2          |
-| [`dotnet restore` audits transitive packages](sdk/10.0/nugetaudit-transitive-packages.md)                                    | Behavioral change                     | Preview 3          |
-| [MSBUILDCUSTOMBUILDEVENTWARNING escape hatch removed](sdk/10.0/custom-build-event-warning.md)                                | Behavioral change                     | Preview 1          |
-| [MSBuild custom culture resource handling](sdk/10.0/msbuild-custom-culture.md)                                               | Behavioral change                     | Preview 1          |
-| [NU1510 is raised for direct references pruned by NuGet](sdk/10.0/nu1510-pruned-references.md)                               | Source incompatible                   | Preview 1          |
-| [HTTP warnings promoted to errors in `dotnet package list` and `dotnet package search`](sdk/10.0/http-warnings-to-errors.md) | Behavioral/source incompatible change | Preview 4          |
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [.NET CLI `--interactive` defaults to `true` in user scenarios](sdk/10.0/dotnet-cli-interactive.md) | Behavioral change | Preview 3 |
+| [Default workload configuration from 'loose manifests' to 'workload sets' mode](sdk/10.0/default-workload-config.md) | Behavioral change | Preview 2 |
+| [`dotnet package list` performs restore](sdk/10.0/dotnet-package-list-restore.md) | Behavioral change | Preview 4 |
+| [`dotnet restore` audits transitive packages](sdk/10.0/nugetaudit-transitive-packages.md) | Behavioral change | Preview 3 |
+| [MSBUILDCUSTOMBUILDEVENTWARNING escape hatch removed](sdk/10.0/custom-build-event-warning.md) | Behavioral change | Preview 1 |
+| [MSBuild custom culture resource handling](sdk/10.0/msbuild-custom-culture.md) | Behavioral change | Preview 1 |
+| [NU1510 is raised for direct references pruned by NuGet](sdk/10.0/nu1510-pruned-references.md) | Source incompatible | Preview 1 |
+| [HTTP warnings promoted to errors in `dotnet package list` and `dotnet package search`](sdk/10.0/http-warnings-to-errors.md) | Behavioral/source incompatible change | Preview 4 |
 
 ## Windows Forms
 
-| Title                                                                                                                                         | Type of change      | Introduced version |
-|-----------------------------------------------------------------------------------------------------------------------------------------------|---------------------|--------------------|
-| [API obsoletions](windows-forms/10.0/obsolete-apis.md)                                                                                        | Source incompatible | Preview 1          |
-| [Applications referencing both WPF and WinForms must disambiguate MenuItem and ContextMenu types](windows-forms/10.0/menuitem-contextmenu.md) | Source incompatible | Preview 1          |
-| [Renamed parameter in HtmlElement.InsertAdjacentElement](windows-forms/10.0/insertadjacentelement-orientation.md)                             | Source incompatible | Preview 1          |
-| [TreeView checkbox image truncation](windows-forms/10.0/treeview-text-location.md)                                                            | Behavioral change   | Preview 1          |
-| [StatusStrip uses System RenderMode by default](windows-forms/10.0/statusstrip-renderer.md)                                                   | Behavioral change   | Preview 1          |
+| Title                                                  | Type of change      | Introduced version |
+|--------------------------------------------------------|---------------------|--------------------|
+| [API obsoletions](windows-forms/10.0/obsolete-apis.md) | Source incompatible | Preview 1          |
+| [Applications referencing both WPF and WinForms must disambiguate MenuItem and ContextMenu types](windows-forms/10.0/menuitem-contextmenu.md) | Source incompatible | Preview 1 |
+| [Renamed parameter in HtmlElement.InsertAdjacentElement](windows-forms/10.0/insertadjacentelement-orientation.md) | Source incompatible | Preview 1 |
+| [TreeView checkbox image truncation](windows-forms/10.0/treeview-text-location.md) | Behavioral change   | Preview 1 |
+| [StatusStrip uses System RenderMode by default](windows-forms/10.0/statusstrip-renderer.md) | Behavioral change   | Preview 1 |
 
 ## Windows Presentation Foundation (WPF)
 
-| Title                                                                                            | Type of change                        | Introduced version |
-|--------------------------------------------------------------------------------------------------|---------------------------------------|--------------------|
+| Title | Type of change                        | Introduced version |
+|-------|---------------------------------------|--------------------|
 | [Incorrect usage of DynamicResource causes application crash](wpf/10.0/dynamicresource-crash.md) | Source incompatible/behavioral change | Preview 4          |
@@ -0,0 +1,43 @@
+---
+title: "Breaking change - dotnet package list command now performs restore by default"
+description: "Learn about the breaking change in .NET 10 where the dotnet package list command now performs a restore before listing packages."
+ms.date: 06/05/2025
+ai-usage: ai-assisted
+ms.custom: https://github.com/dotnet/docs/issues/46103
+---
+
+# dotnet package list command now performs restore by default
+
+The `dotnet package list` command now automatically performs a restore operation before listing packages to ensure accurate and up-to-date results. This is a behavioral change from the previous implementation where the command did not require a restore step. Additionally, if the restore operation fails, an error message is logged.
+
+## Version introduced
+
+.NET 10 Preview 4
+
+## Previous behavior
+
+The `dotnet package list` command listed project packages without performing a restore. If a restore was needed, you had to run it manually before using the command.
+
+## New behavior
+
+The `dotnet package list` command now automatically performs a restore before listing packages. If the restore fails, the command doesn't list packages and instead logs an error message in both plain text and JSON formats, depending on the command usage.
+
+## Type of breaking change
+
+This change is a [behavioral change](../../categories.md#behavioral-change).
+
+## Reason for change
+
+This change ensures the `dotnet package list` command provides accurate and up-to-date package information.
+
+## Recommended action
+
+If this change causes issues in your workflow:
+
+- Use the `--no-restore` option with `dotnet package list` if you want to bypass the implicit restore step.
+- Make sure your project is ready for restore before running the `dotnet package list` command.
+- Alternatively, run `dotnet restore` manually before using `dotnet package list` to decouple the restore step.
+
+## Affected APIs
+
+None.