Skip to content

Assembly name attribute breaking change #43764

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 25, 2024
Merged

Assembly name attribute breaking change #43764

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d8fbffe
assembly name attribute breaking change
gewarren Nov 25, 2024
767b0aa
encode hashmark
gewarren Nov 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/core/compatibility/7.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ If you're migrating an app to .NET 7, the breaking changes listed here might aff
## ASP.NET Core

| Title | Binary compatible | Source compatible |
| - | :-: | :-: |
|-------|:-----------------:|:-----------------:|
| [API controller actions try to infer parameters from DI](aspnet-core/7.0/api-controller-action-parameters-di.md) | ✔️ | ❌ |
| [ASPNET-prefixed environment variable precedence](aspnet-core/7.0/environment-variable-precedence.md) | ✔️ | ✔️ |
| [AuthenticateAsync for remote auth providers](aspnet-core/7.0/authenticateasync-anonymous-request.md) | ✔️ | ❌ |
Expand All @@ -34,9 +34,10 @@ If you're migrating an app to .NET 7, the breaking changes listed here might aff
## Core .NET libraries

| Title | Binary compatible | Source compatible |
| - | :-: | :-: |
|-------|:-----------------:|:-----------------:|
| [API obsoletions with default diagnostic ID](core-libraries/7.0/obsolete-apis-with-default-diagnostic.md) | ✔️ | ❌ |
| [API obsoletions with non-default diagnostic IDs](core-libraries/7.0/obsolete-apis-with-custom-diagnostics.md) | ✔️ | ❌ |
| [Asterisk no longer accepted for assembly name attributes](core-libraries/7.0/assembly-name-wildcard.md) | ✔️ | ✔️ |
| [BinaryFormatter serialization APIs produce compiler errors](serialization/7.0/binaryformatter-apis-produce-errors.md) | ✔️ | ❌ |
| [BrotliStream no longer allows undefined CompressionLevel values](core-libraries/7.0/brotlistream-ctor.md) | ❌ | ✔️ |
| [C++/CLI projects in Visual Studio](core-libraries/7.0/cpluspluscli-compiler-version.md) | ✔️ | ❌ |
Expand Down
55 changes: 55 additions & 0 deletions docs/core/compatibility/core-libraries/7.0/assembly-name-wildcard.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: "Breaking change: Asterisk no longer accepted for assembly name attributes"
description: Learn about the breaking change in core .NET libraries in .NET 7 where assembly names no longer accept '*' as a wildcard attribute value.
ms.date: 11/25/2024
ai-usage: ai-assisted
ms.custom: https://github.com/dotnet/docs/issues/42598
---

# Asterisk no longer accepted for assembly name attributes

Prior to .NET 7, assembly names allowed specifying `*` as a wildcard value for an attribute value, which was equivalent to not specifying the value at all. This undocumented feature was removed in .NET 7.

## Version introduced

.NET 7

## Previous behavior

Previously, you could specify `*` as a value for assembly name attributes. For example, the following code succeeded:

```csharp
Assembly.Load("System.Runtime, Version=*, PublicKeyToken=*");
```

The asterisk had identical behavior to not specifying the attribute value at all:

```csharp
Assembly.Load("System.Runtime");
```

## New behavior

Starting in .NET 7, the following code fails with a <xref:System.IO.FileLoadException> with the error message "The given assembly name was invalid".

```csharp
Assembly.Load("System.Runtime, Version=*, PublicKeyToken=*")
```

## Type of breaking change

This change is a [behavioral change](../../categories.md#behavioral-change).

## Reason for change

The previous behavior was an undocumented feature and it wasn't consistent implemented by all .NET assembly name parsers. The undocumented feature was removed to unify the behavior of assembly name parsing throughout .NET.

## Recommended action

Omit assembly name attributes that have a wildcard value. For example, change `System.Runtime, Version=*` to just `System.Runtime`.

## Affected APIs

- <xref:System.Reflection.Assembly.Load(System.String)?displayProperty=fullName>
- <xref:System.Type.GetType(System.String)?displayProperty=fullName>
- <xref:System.Reflection.AssemblyName.%23ctor(System.String)?displayProperty=fullName>
4 changes: 4 additions & 0 deletions docs/core/compatibility/toc.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -394,6 +394,8 @@ items:
href: core-libraries/7.0/obsolete-apis-with-default-diagnostic.md
- name: API obsoletions with non-default diagnostic IDs
href: core-libraries/7.0/obsolete-apis-with-custom-diagnostics.md
- name: Asterisk no longer accepted for assembly name attributes
href: core-libraries/7.0/assembly-name-wildcard.md
- name: BrotliStream no longer allows undefined CompressionLevel values
href: core-libraries/7.0/brotlistream-ctor.md
- name: C++/CLI projects in Visual Studio
Expand Down Expand Up @@ -1362,6 +1364,8 @@ items:
href: core-libraries/7.0/obsolete-apis-with-default-diagnostic.md
- name: API obsoletions with non-default diagnostic IDs
href: core-libraries/7.0/obsolete-apis-with-custom-diagnostics.md
- name: Asterisk no longer accepted for assembly name attributes
href: core-libraries/7.0/assembly-name-wildcard.md
- name: BrotliStream no longer allows undefined CompressionLevel values
href: core-libraries/7.0/brotlistream-ctor.md
- name: C++/CLI projects in Visual Studio
Expand Down