Skip to content
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

.NET 7 obsoletions #31936

Merged
merged 1 commit into from
Nov 8, 2022
Merged

.NET 7 obsoletions #31936

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
1 change: 1 addition & 0 deletions docs/core/compatibility/7.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ If you're migrating an app to .NET 7, the breaking changes listed here might aff

| Title | Binary compatible | Source compatible | Introduced |
| - | :-: | :-: | - |
| [API obsoletions with default diagnostic ID](core-libraries/7.0/obsolete-apis-with-default-diagnostic.md) | ✔️ | ❌ | Preview 3 |
| [API obsoletions with non-default diagnostic IDs](core-libraries/7.0/obsolete-apis-with-custom-diagnostics.md) | ✔️ | ❌ | Preview 1 |
| [BinaryFormatter serialization APIs produce compiler errors](core-libraries/7.0/binaryformatter-apis-produce-errors.md) | ✔️ | ❌ | RC 1 |
| [C++/CLI projects in Visual Studio](core-libraries/7.0/cpluspluscli-compiler-version.md) | ✔️ | ❌ | Preview 3 |
Expand Down
53 changes: 53 additions & 0 deletions .../core/compatibility/core-libraries/7.0/obsolete-apis-with-default-diagnostic.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: "Breaking change: .NET 7 obsoletions with default diagnostic ID"
titleSuffix: ""
description: Learn about the .NET 7 breaking change in core .NET libraries where some APIs have been marked as obsolete with the default diagnostic ID.
ms.date: 10/19/2022
---
# API obsoletions with default diagnostic ID (.NET 7)

Several [APIs](#affected-apis) have been marked as obsolete in .NET 7. Referencing these APIs in your code will result in build warnings. In C#, the compiler diagnostic for these obsoletions is [CS0618](../../../../csharp/language-reference/compiler-messages/cs0618.md).

## Previous behavior

Previously, the affected APIs could be referenced without any build warnings.

## New behavior

Starting in .NET 7, referencing the affected APIs will result in build warnings.

## Version introduced

.NET 7 Preview 3

## Type of breaking change

These obsoletions can affect [source compatibility](../../categories.md#source-compatibility).

## Reason for change

These APIs were previously marked obsolete in the implementation assemblies but not in the [reference assemblies](../../../../standard/assembly/reference-assemblies.md). The reference assemblies have now been updated to match the implementation assemblies.

## Recommended action

Follow the recommended action that's emitted when you use the obsolete API.

## Affected APIs
gewarren marked this conversation as resolved.
Show resolved Hide resolved

- <xref:System.ComponentModel.IComNativeDescriptorHandler?displayProperty=fullName>
- <xref:System.ComponentModel.MemberDescriptor.GetInvokee(System.Type,System.Object)?displayProperty=fullName>
- <xref:System.ComponentModel.RecommendedAsConfigurableAttribute?displayProperty=fullName>
gewarren marked this conversation as resolved.
Show resolved Hide resolved
- <xref:System.Data.OleDb.OleDbParameterCollection.Add(System.String,System.Object)?displayProperty=fullName>
- <xref:System.Net.FileWebRequest.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.FileWebRequest.System%23Runtime%23Serialization%23ISerializable%23GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.FileWebResponse.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.FileWebResponse.System%23Runtime%23Serialization%23ISerializable%23GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.Http.HttpRequestMessage.Properties?displayProperty=fullName>
gewarren marked this conversation as resolved.
Show resolved Hide resolved
- <xref:System.Net.WebRequest.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.WebRequest.System%23Runtime%23Serialization%23ISerializable%23GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.WebResponse.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> constructor
- <xref:System.Net.WebResponse.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Net.WebResponse.System%23Runtime%23Serialization%23ISerializable%23GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=fullName>
- <xref:System.Security.Cryptography.PasswordDeriveBytes.GetBytes(System.Int32)?displayProperty=fullName>
- <xref:System.Web.HttpUtility.UrlEncodeUnicode(System.String)?displayProperty=fullName>
- <xref:System.Web.HttpUtility.UrlEncodeUnicodeToBytes(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 @@ -55,6 +55,8 @@ items:
href: aspnet-core/7.0/signalr-hub-method-parameters-di.md
- name: Core .NET libraries
items:
- name: API obsoletions with default diagnostic ID
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: BinaryFormatter serialization APIs produce compiler errors
Expand Down Expand Up @@ -831,6 +833,8 @@ items:
items:
- name: .NET 7
items:
- name: API obsoletions with default diagnostic ID
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: BinaryFormatter serialization APIs produce compiler errors
Expand Down