|
1 | 1 | --- |
2 | 2 | title: "Removal of WCF APIs with a `configurationName` parameter" |
3 | | -description: Learn about the breaking change in .NET 8 where the WCF APIs that accept a `configurationName` parameter have been removed. |
| 3 | +description: Learn about the breaking change in WCF 8 where the APIs that accept a `configurationName` parameter have been removed. |
4 | 4 | ms.date: 11/13/2024 |
5 | 5 | ai-usage: ai-assisted |
6 | 6 | ms.custom: https://github.com/dotnet/docs/issues/43111 |
7 | 7 | --- |
8 | 8 |
|
9 | 9 | # Removal of WCF APIs with a `configurationName` parameter |
10 | 10 |
|
11 | | -The WCF APIs that accept either a `configurationName` parameter or an `endpointConfigurationName` parameter have been removed in .NET 8. These APIs were previously used in .NET Framework to load client configuration parameters such as the `Binding` configuration and the `EndpointAddress` details. |
| 11 | +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. |
12 | 12 |
|
13 | 13 | ## Version introduced |
14 | 14 |
|
15 | | -.NET 8 GA |
| 15 | +WCF Client 8.0 GA |
16 | 16 |
|
17 | 17 | ## Previous behavior |
18 | 18 |
|
19 | | -The removed APIs were previously suppressed from IntelliSense suggestions. Using any of the removed APIs resulted in a <xref:System.PlatformNotSupportedException> being thrown. |
| 19 | +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 <xref:System.PlatformNotSupportedException> at run time. |
20 | 20 |
|
21 | 21 | ## New behavior |
22 | 22 |
|
23 | | -The APIs no longer exist. If you upgrade to .NET 8 and recompile your code, it will fail. |
| 23 | +The [affected APIs](#affected-apis) no longer exist. If you upgrade to WCF 8 and recompile your project, it will fail. |
24 | 24 |
|
25 | 25 | ## Type of breaking change |
26 | 26 |
|
27 | | -This change is a [binary incompatible](../../categories.md#binary-incompatible) and [source incompatible](../../categories.md#source-incompatible) change. |
| 27 | +This change is a [binary incompatible](../../categories.md#binary-compatibility) and [source incompatible](../../categories.md#source-compatibility) change. |
28 | 28 |
|
29 | 29 | ## Reason for change |
30 | 30 |
|
31 | | -These APIs were never implemented on .NET and any calls to these APIs previously resulted in a run-time exception. |
| 31 | +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. |
32 | 32 |
|
33 | 33 | ## Recommended action |
34 | 34 |
|
35 | | -Remove any usage of these APIs. |
| 35 | +Remove any usage of the [affected APIs](#affected-apis). |
36 | 36 |
|
37 | 37 | 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 <xref:System.ServiceModel.ClientBase`1> or <xref:System.ServiceModel.DuplexClientBase`1>. The generated constructors were unusable on .NET as they resulted in a `PlatformNotSupportedException` being thrown. |
38 | 38 |
|
|
0 commit comments