Skip to content

Commit 97a9a13

Browse files
gewarrengewarren
authored
Final updates for .NET 9 release (dotnet#43719)
1 parent e793387 commit 97a9a13

File tree

12 files changed

+103
-125
lines changed

12 files changed

+103
-125
lines changed

‎.openpublishing.redirection.fsharp.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@
151151
},
152152
{
153153
"source_path_from_root": "/docs/fsharp/whats-new/index.md",
154-
"redirect_url": "/dotnet/fsharp/whats-new/fsharp-6",
154+
"redirect_url": "/dotnet/fsharp/whats-new/fsharp-9",
155155
"ms.custom": "updateeachrelease"
156156
},
157157
{

‎api/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ description: Explore Microsoft's comprehensive .NET API browser. Your ultimate r
33
layout: ApiBrowserPage
44
hide_bc: true
55
title: .NET API browser
6-
quickFilterColumn1: net-9.0,netframework-4.8,netstandard-2.1
6+
quickFilterColumn1: net-9.0,netframework-4.8.1,netstandard-2.1
77
quickFilterColumn2: aspnetcore-9.0,efcore-8.0,net-maui-9.0
88
quickFilterColumn3: azure-dotnet,ml-dotnet,spark-dotnet
99
ms.topic: landing-page

‎docs/core/compatibility/core-libraries/9.0/obsolete-apis-with-custom-diagnostics.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ In previous .NET versions, these APIs can be used without any build warning. In
1515
The following table lists the custom diagnostic IDs and their corresponding warning messages for obsoleted APIs.
1616

1717
| Diagnostic ID | Description | Severity |
18-
| - | - |
18+
|---------------|-------------|----------|
1919
| [SYSLIB0009](../../../../fundamentals/syslib-diagnostics/syslib0009.md) | <xref:System.Net.AuthenticationManager> is not supported. Methods will no-op or throw <xref:System.PlatformNotSupportedException>. | Warning |
20-
| [SYSLIB0014: WebRequest, HttpWebRequest, ServicePoint, WebClient are obsolete](../../../../fundamentals/syslib-diagnostics/syslib0014.md) | <xref:System.Net.ServicePointManager> is fully obsolete. Settings on <xref:System.Net.ServicePointManager> don't affect <xref:System.Net.Security.SslStream> or <xref:System.Net.Http.HttpClient> (this behavior hasn't changed since .NET 6). | Warning |
20+
| [SYSLIB0014](../../../../fundamentals/syslib-diagnostics/syslib0014.md) | <xref:System.Net.ServicePointManager> is fully obsolete. Settings on <xref:System.Net.ServicePointManager> don't affect <xref:System.Net.Security.SslStream> or <xref:System.Net.Http.HttpClient> (this behavior hasn't changed since .NET 6). | Warning |
2121
| [SYSLIB0054](../../../../fundamentals/syslib-diagnostics/syslib0054.md) | <xref:System.Threading.Thread.VolatileRead%2A?displayProperty=nameWithType> and <xref:System.Threading.Thread.VolatileWrite%2A?displayProperty=nameWithType> are obsolete. Use <xref:System.Threading.Volatile.Read%2A?displayProperty=nameWithType> or <xref:System.Threading.Volatile.Write%2A?displayProperty=nameWithType> instead. | Warning |
2222
| [SYSLIB0055](../../../../fundamentals/syslib-diagnostics/syslib0055.md) | `AdvSimd.ShiftRightLogicalRoundedNarrowingSaturate*` methods with signed parameters are obsolete. Use the unsigned overloads instead. | Warning |
2323
| [SYSLIB0056](../../../../fundamentals/syslib-diagnostics/syslib0056.md) | `Assembly.LoadFrom` with a custom `AssemblyHashAlgorithm` is obsolete. Use overloads without an `AssemblyHashAlgorithm`. | Warning |

‎docs/core/compatibility/unsupported-apis.md

Lines changed: 41 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Unsupported APIs on .NET Core and .NET 5+
33
titleSuffix: ""
44
description: Learn which .NET APIs always throw an exception on .NET Core and .NET 5 and later versions.
5-
ms.date: 08/22/2023
5+
ms.date: 11/22/2024
66
---
77
# APIs that always throw exceptions on .NET Core and .NET 5+
88

@@ -17,9 +17,9 @@ This article organizes the affected APIs by namespace.
1717
1818
## System
1919

20-
| Member | Platforms that throw |
21-
| - | - |
22-
| <xref:System.AppDomain.CreateDomain%2A?displayProperty=nameWithType> | All |
20+
| Member | Platforms that throw |
21+
|----------------------------------------------------------------------|----------------------|
22+
| <xref:System.AppDomain.CreateDomain%2A?displayProperty=nameWithType> | All |
2323
| <xref:System.AppDomain.ExecuteAssembly(System.String,System.String[],System.Byte[],System.Configuration.Assemblies.AssemblyHashAlgorithm)?displayProperty=nameWithType> | All |
2424
| <xref:System.AppDomain.Unload(System.AppDomain)?displayProperty=nameWithType> | All |
2525
| <xref:System.Console.CapsLock?displayProperty=nameWithType> | Linux and macOS |
@@ -34,29 +34,29 @@ This article organizes the affected APIs by namespace.
3434
## System.CodeDom.Compiler
3535

3636
| Member | Platforms that throw |
37-
| - | - |
37+
|--------|----------------------|
3838
| <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromDom%2A?displayProperty=nameWithType> | All |
3939
| <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromFile%2A?displayProperty=nameWithType> | All |
4040
| <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromSource%2A?displayProperty=nameWithType> | All |
4141

4242
## System.Collections.Specialized
4343

4444
| Member | Platforms that throw |
45-
| - | - |
45+
|--------|----------------------|
4646
| <xref:System.Collections.Specialized.NameObjectCollectionBase.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
4747
| <xref:System.Collections.Specialized.NameObjectCollectionBase.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
4848
| <xref:System.Collections.Specialized.NameObjectCollectionBase.OnDeserialization(System.Object)?displayProperty=nameWithType> | All |
4949

5050
## System.Configuration
5151

5252
| Member | Platforms that throw |
53-
| - | - |
53+
|--------|----------------------|
5454
| <xref:System.Configuration.RsaProtectedConfigurationProvider?displayProperty=nameWithType> (all members) | All |
5555

5656
## System.Console
5757

5858
| Member | Platforms that throw |
59-
| - | - |
59+
|--------|----------------------|
6060
| <xref:System.Console.Beep?displayProperty=nameWithType> | Linux and macOS |
6161
| <xref:System.Console.BufferHeight?displayProperty=nameWithType> (set only) | Linux and macOS |
6262
| <xref:System.Console.BufferWidth?displayProperty=nameWithType> (set only) | Linux and macOS |
@@ -74,13 +74,13 @@ This article organizes the affected APIs by namespace.
7474
## System.Data.Common
7575

7676
| Member | Platforms that throw |
77-
| - | - |
77+
|--------|----------------------|
7878
| <xref:System.Data.Common.DbDataReader.GetSchemaTable%2A?displayProperty=nameWithType> (throws <xref:System.NotSupportedException>) | All |
7979

8080
## System.Diagnostics.Process
8181

8282
| Member | Platforms that throw |
83-
| - | - |
83+
|--------|----------------------|
8484
| <xref:System.Diagnostics.Process.MaxWorkingSet?displayProperty=nameWithType> (set only) | Linux |
8585
| <xref:System.Diagnostics.Process.MinWorkingSet?displayProperty=nameWithType> (set only) | Linux |
8686
| <xref:System.Diagnostics.Process.ProcessorAffinity?displayProperty=nameWithType> | macOS |
@@ -98,14 +98,14 @@ This article organizes the affected APIs by namespace.
9898
## System.IO
9999

100100
| Member | Platforms that throw |
101-
| - | - |
101+
|--------|----------------------|
102102
| <xref:System.IO.FileSystemInfo.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
103103
| <xref:System.IO.FileSystemInfo.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
104104

105105
## System.IO.Pipes
106106

107107
| Member | Platforms that throw |
108-
| - | - |
108+
|--------|----------------------|
109109
| <xref:System.IO.Pipes.NamedPipeClientStream.NumberOfServerInstances?displayProperty=nameWithType> | Linux and macOS |
110110
| <xref:System.IO.Pipes.NamedPipeServerStream.GetImpersonationUserName?displayProperty=nameWithType> | Linux and macOS |
111111
| <xref:System.IO.Pipes.PipeStream.InBufferSize?displayProperty=nameWithType> | Linux and macOS |
@@ -116,13 +116,14 @@ This article organizes the affected APIs by namespace.
116116
## System.Media
117117

118118
| Member | Platforms that throw |
119-
| - | - |
119+
|--------|----------------------|
120120
| <xref:System.Media.SoundPlayer.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
121121

122122
## System.Net
123123

124-
| Member | Platforms that throw |
125-
| - | - |
124+
| Member | Platforms that throw |
125+
|-------------------------------------------------------------------|----------------------|
126+
| <xref:System.Net.AuthenticationManager?displayProperty=fullName>\* | All |
126127
| <xref:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)?displayProperty=nameWithType> | All |
127128
| <xref:System.Net.AuthenticationManager.PreAuthenticate(System.Net.WebRequest,System.Net.ICredentials)?displayProperty=nameWithType> | All |
128129
| <xref:System.Net.FileWebRequest.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
@@ -141,29 +142,31 @@ This article organizes the affected APIs by namespace.
141142
| <xref:System.Net.WebResponse.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
142143
| <xref:System.Net.WebResponse.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
143144

145+
\* .NET 9 and later versions.
146+
144147
## System.Net.NetworkInformation
145148

146149
| Member | Platforms that throw |
147-
| - | - |
150+
|--------|----------------------|
148151
| <xref:System.Net.NetworkInformation.Ping.Send%2A?displayProperty=nameWithType> | Windows (UWP) |
149152

150153
## System.Net.Sockets
151154

152155
| Member | Platforms that throw |
153-
| - | - |
156+
|--------|----------------------|
154157
| <xref:System.Net.Sockets.Socket.%23ctor(System.Net.Sockets.SocketInformation)> | All |
155158
| <xref:System.Net.Sockets.Socket.DuplicateAndClose(System.Int32)?displayProperty=nameWithType> | All |
156159

157160
## System.Net.WebSockets
158161

159162
| Member | Platforms that throw |
160-
| - | - |
163+
|--------|----------------------|
161164
| <xref:System.Net.WebSockets.WebSocket.RegisterPrefixes?displayProperty=nameWithType> | All |
162165

163166
## System.Reflection
164167

165168
| Member | Platforms that throw |
166-
| - | - |
169+
|--------|----------------------|
167170
| <xref:System.Reflection.Assembly.CodeBase?displayProperty=nameWithType> | All |
168171
| <xref:System.Reflection.Assembly.EscapedCodeBase?displayProperty=nameWithType> | All |
169172
| <xref:System.Reflection.Assembly.LoadFrom(System.String,System.Byte[],System.Configuration.Assemblies.AssemblyHashAlgorithm)?displayProperty=nameWithType> | All |
@@ -178,13 +181,13 @@ This article organizes the affected APIs by namespace.
178181
## System.Runtime.CompilerServices
179182

180183
| Member | Platforms that throw |
181-
| - | - |
184+
|--------|----------------------|
182185
| <xref:System.Runtime.CompilerServices.DebugInfoGenerator.CreatePdbGenerator?displayProperty=nameWithType> | All |
183186

184187
## System.Runtime.InteropServices
185188

186189
| Member | Platforms that throw |
187-
| - | - |
190+
|--------|----------------------|
188191
| <xref:System.Runtime.InteropServices.IDispatchImplAttribute> | All |
189192
| <xref:System.Runtime.InteropServices.Marshal.GetIDispatchForObject(System.Object)?displayProperty=nameWithType> | All |
190193
| <xref:System.Runtime.InteropServices.RuntimeEnvironment.SystemConfigurationFile?displayProperty=nameWithType> | All |
@@ -197,17 +200,19 @@ This article organizes the affected APIs by namespace.
197200
## System.Runtime.Serialization
198201

199202
| Member | Platforms that throw |
200-
| - | - |
201-
| <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize(System.IO.Stream,System.Object)?displayProperty=fullName>* | All |
202-
| <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Deserialize(System.IO.Stream)?displayProperty=nameWithType>* | All |
203+
|--------|----------------------|
204+
| <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize(System.IO.Stream,System.Object)?displayProperty=fullName>\* | All |
205+
| <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize(System.IO.Stream,System.Object)?displayProperty=fullName>† | All |
206+
| <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Deserialize(System.IO.Stream)?displayProperty=nameWithType>† | All |
203207
| <xref:System.Runtime.Serialization.XsdDataContractExporter.Schemas?displayProperty=nameWithType> | All |
204208

205-
\* .NET 8 and later versions only for all project types except Windows Forms and WPF.
209+
\* .NET 9 and later versions.
210+
† .NET 8 only for all project types except Windows Forms and WPF.
206211

207212
## System.Security
208213

209214
| Member | Platforms that throw |
210-
| - | - |
215+
|--------|----------------------|
211216
| <xref:System.Security.CodeAccessPermission.Deny?displayProperty=nameWithType> | All |
212217
| <xref:System.Security.CodeAccessPermission.PermitOnly?displayProperty=nameWithType> | All |
213218
| <xref:System.Security.PermissionSet.ConvertPermissionSet(System.String,System.Byte[],System.String)?displayProperty=nameWithType> | All |
@@ -226,7 +231,7 @@ This article organizes the affected APIs by namespace.
226231
## System.Security.Claims
227232

228233
| Member | Platforms that throw |
229-
| - | - |
234+
|--------|----------------------|
230235
| <xref:System.Security.Claims.ClaimsPrincipal.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
231236
| <xref:System.Security.Claims.ClaimsPrincipal.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
232237
| <xref:System.Security.Claims.ClaimsIdentity.%23ctor(System.Runtime.Serialization.SerializationInfo)> | All |
@@ -236,7 +241,7 @@ This article organizes the affected APIs by namespace.
236241
## System.Security.Cryptography
237242

238243
| Member | Platforms that throw |
239-
| - | - |
244+
|--------|----------------------|
240245
| <xref:System.Security.Cryptography.AsymmetricAlgorithm.Create(System.String)?displayProperty=nameWithType> | All |
241246
| <xref:System.Security.Cryptography.CngAlgorithm?displayProperty=nameWithType> | Linux and macOS |
242247
| <xref:System.Security.Cryptography.CngAlgorithmGroup?displayProperty=nameWithType> | Linux and macOS |
@@ -289,14 +294,14 @@ This article organizes the affected APIs by namespace.
289294
## System.Security.Cryptography.Pkcs
290295

291296
| Member | Platforms that throw |
292-
| - | - |
297+
|--------|----------------------|
293298
| <xref:System.Security.Cryptography.Pkcs.CmsSigner.%23ctor(System.Security.Cryptography.CspParameters)> | All |
294299
| <xref:System.Security.Cryptography.Pkcs.SignerInfo.ComputeCounterSignature?displayProperty=nameWithType> | All |
295300

296301
## System.Security.Cryptography.X509Certificates
297302

298303
| Member | Platforms that throw |
299-
| - | - |
304+
|--------|----------------------|
300305
| <xref:System.Security.Cryptography.X509Certificates.X509Certificate.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
301306
| <xref:System.Security.Cryptography.X509Certificates.X509Certificate.Import%2A?displayProperty=nameWithType> | All |
302307
| <xref:System.Security.Cryptography.X509Certificates.X509Certificate2.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
@@ -305,31 +310,31 @@ This article organizes the affected APIs by namespace.
305310
## System.Security.Authentication.ExtendedProtection
306311

307312
| Member | Platforms that throw |
308-
| - | - |
313+
|--------|----------------------|
309314
| <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
310315

311316
## System.Security.Policy
312317

313318
| Member | Platforms that throw |
314-
| - | - |
319+
|--------|----------------------|
315320
| <xref:System.Security.Policy.Hash.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
316321

317322
## System.ServiceProcess.ServiceController
318323

319324
| Member | Platforms that throw |
320-
| - | - |
325+
|--------|----------------------|
321326
| <xref:System.ServiceProcess.TimeoutException.%23ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)> | All |
322327

323328
## System.Text.RegularExpressions
324329

325330
| Member | Platforms that throw |
326-
| - | - |
331+
|--------|----------------------|
327332
| <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=nameWithType> | All |
328333

329334
## System.Threading
330335

331336
| Member | Platforms that throw |
332-
| - | - |
337+
|--------|----------------------|
333338
| <xref:System.Threading.CompressedStack.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
334339
| <xref:System.Threading.ExecutionContext.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)?displayProperty=nameWithType> | All |
335340
| <xref:System.Threading.Thread.Abort%2A?displayProperty=nameWithType> | All |
@@ -340,7 +345,7 @@ This article organizes the affected APIs by namespace.
340345
## System.Xml
341346

342347
| Member | Platforms that throw |
343-
| - | - |
348+
|--------|----------------------|
344349
| <xref:System.Xml.XmlDictionaryReader.CreateMtomReader(System.Byte[],System.Int32,System.Int32,System.Text.Encoding[],System.String,System.Xml.XmlDictionaryReaderQuotas,System.Int32,System.Xml.OnXmlDictionaryReaderClose)?displayProperty=nameWithType> | All |
345350
| <xref:System.Xml.XmlDictionaryReader.CreateMtomReader(System.IO.Stream,System.Text.Encoding[],System.String,System.Xml.XmlDictionaryReaderQuotas,System.Int32,System.Xml.OnXmlDictionaryReaderClose)?displayProperty=nameWithType> | All |
346351
| <xref:System.Xml.XmlDictionaryWriter.CreateMtomWriter(System.IO.Stream,System.Text.Encoding,System.Int32,System.String,System.String,System.String,System.Boolean,System.Boolean)?displayProperty=nameWithType> | All |

0 commit comments

Comments
 (0)