Releases: dotnet/wcf
WCF for .NET Core 2.1 Release Candidate (RC)
Release Notes
This is part of .NET Core 2.1 RC1 released on 5/6/2018 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.5.0-rc1-26502.06
- System.ServiceModel.Http 4.5.0-rc1-26502.06
- System.ServiceModel.NetTcp 4.5.0-rc1-26502.06
- System.ServiceModel.Primitives 4.5.0-rc1-26502.06
- System.ServiceModel.Security 4.5.0-rc1-26502.06
What's New
- Added support to use the new HttpClientHandler’s support of 100-Continue for authenticated scenarios to improve performance, and avoid a potential race condition deadlock when using client certificates. (#2753)
- Enabled WCF NuGet package signing to be compliant with the new nuget.org standard. (#2749)
WCF for .NET Core 2.1 Preview 2
Release Notes
This is part of .NET Core 2.1 Preview 2 released on 4/10/2018 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.5.0-preview2-26410-01
- System.ServiceModel.Http 4.5.0-preview2-26410-01
- System.ServiceModel.NetTcp 4.5.0-preview2-26410-01
- System.ServiceModel.Primitives 4.5.0-preview2-26410-01
- System.ServiceModel.Security 4.5.0-preview2-26410-01
What's New
- Added support for providing a delegate to modify/replace HttpClientHandler in ChannelFactory (#2400).
- Added support for System.ServiceModel.ChannelTerminatedException (#1962).
- Added support for BasicHttpSecurity to contain a constructor that takes 0 arguments (#2365).
- Added support for ClientBase<TChannel>.Close() (#2282).
WCF for .NET Core 2.1 Preview 1
Release Notes
This is part of .NET Core 2.1 Preview 1 released on 2/27/2018 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.5.0-preview1-26228-01
- System.ServiceModel.Http 4.5.0-preview1-26228-01
- System.ServiceModel.NetTcp 4.5.0-preview1-26228-01
- System.ServiceModel.Primitives 4.5.0-preview1-26228-01
- System.ServiceModel.Security 4.5.0-preview1-26228-01
What's New
- Added support for portable runtime identifier: win (#2349).
- Added support for the custom proxy address for Http & Https bindings on *nix in addition to Windows (#1592).
- Added support for the control of making a persistent connection to a service endpoint (#2389).
- Fixed the issue that the networking stack may time out a request after 30 seconds (#2368).
- Added the shim of System.ServiceModel.dll in System.ServiceModel.Primitives package so assemblies compiled against .NET Framework can run on .NET Core (dotnet/standard#575).
- Added support for
MessageVersion.Soap12WSAddressingAugust2004
(#2096). - Added
IDisposable
support toClientBase<TChannel>
(#2022).
WCF for .NET Core 2.0.0
Release Notes
This is part of .NET Core 2.0.0 released on 8/14/2017 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.4.0
- System.ServiceModel.Http 4.4.0
- System.ServiceModel.NetTcp 4.4.0
- System.ServiceModel.Primitives 4.4.0
- System.ServiceModel.Security 4.4.0
What's New
Please refer to the table of Supported Features for a complete list of features that are supported by this release. Besides various bug fixes, here are a few highlights of improvements since 1.1 release.
- Support of .NET Standard 2.0
- Support of new scenarios enabled by API additions (list)
- Added support of SOAP headers (#702)
- Added support of SOAP encoded message (#1549)
- Added support of service operation that can initiate or close sessions (#1402)
- Added support of custom proxy address for Http & Https bindings on Windows (#1592)
- Windows authentication is now supported by Http transport on Linux and OS X (#946)
- Perf runs cover 20 scenarios on 3 bindings (Http, NetTcp, and NetHttp) and show healthy improvements across the board comparing to .NET Core v1.1, especially in asynchronous tests. The largest increase was recorded in NetTcp HelloWorld (+29%) and Http Streaming (+27%) tests.
- Stress runs cover over 40 scenarios which include ‘regular’ (no security) Windows and Linux runs, Windows auth on Windows, and certificate auth on Windows and Linux. Each combination runs short haul for 15 hours with strict monitoring of various timeouts and generally very low tolerance towards any transient errors.
- Various bug fixes and reliability improvement (list)
WCF Connected Service Provider
The WCF Connected Service Provider (Preview) is an extension for Visual Studio 2017 to assist WCF developers to generate WCF client proxy code in .NET Core & ASP.NET Core applications. An update was released today with support for projects built on .NET Core/.NET Standard/ASP.NET Core 2.0.
Known Issues
For a complete list of known issues, please see this issue list. Note, the enhancement for UWP will be in a separate release in near future. The UWP support in this release is the same as the support in 1.1 release.
WCF for .NET Core 2.0.0 Preview2
Release Notes
This is part of .NET Core 2.0.0 Preview 2 released on 6/28/2017 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.4.0-preview2-25419-01
- System.ServiceModel.Http 4.4.0-preview2-25419-01
- System.ServiceModel.NetTcp 4.4.0-preview2-25419-01
- System.ServiceModel.Primitives 4.4.0-preview2-25419-01
- System.ServiceModel.Security 4.4.0-preview2-25419-01
What's New
In addition to what is already in Preview 1 release, this Preview 2 release
- Added support of SOAP encoded message (#1549)
- Added support of service operation that can initiate or close sessions (#1402)
- Added support of custom proxy address for Http & Https bindings on Windows (#1592)
- Various bug fixes and reliability improvement (list)
WCF Connected Service Provider
The WCF Connected Service Provider (Preview) is an extension for Visual Studio 2017 to assist WCF developers to generate WCF client proxy code in .NET Core & ASP.NET Core applications. An update was released today. Among other enhancements, it added support for projects built on .NET Core 2.0 Preview 2 or ASP.NET Core 2.0 Preview 2.
Known Issues
- Message level security is not supported (#3, #4, #8)
- SpnEndpointIdentity is not supported (#11)
- Windows authentication is not supported by NetTcp transport on UWP (#1235)
For a complete list of known issues, please see this issue list.
WCF for .NET Core 2.0.0 Preview1
Release Notes
This is part of .NET Core 2.0.0 Preview 1 released on 5/10/2017 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.4.0-preview1-25303-02
- System.ServiceModel.Http 4.4.0-preview1-25303-02
- System.ServiceModel.NetTcp 4.4.0-preview1-25303-02
- System.ServiceModel.Primitives 4.4.0-preview1-25303-02
- System.ServiceModel.Security 4.4.0-preview1-25303-02
What's New
- Built on .NET Standard 2.0
- Various new features and API additions (list)
- Added support for SOAP headers (#702)
- Windows authentication is now supported by Http transport on Linux and OS X (#946)
- Various bug fixes in functional and reliability improvement (list)
Known Issues
- Message level security is not supported (#3, #4, #8)
- SpnEndpointIdentity are not supported (#11)
- Windows authentication is not supported by NetTcp transport on UWP (#1235)
For a complete list of known issues, please see this issue list.
WCF for .NET Core 1.1
Release Notes
This is part of .NET Core 1.1 released on 11/16/2016 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.3.0
- System.ServiceModel.Http 4.3.0
- System.ServiceModel.NetTcp 4.3.0
- System.ServiceModel.Primitives 4.3.0
- System.ServiceModel.Security 4.3.0
What's New
Please refer to the table of Supported Features for a complete list of features that are supported by this release. Besides various bug fixes, here are a few highlights of improvements since 1.0 release.
- Improved performance when calling a service using a synchronous channel during times of thread starvation in the threadpool.
- WebSocket is now supported on Linux and OS X in addition to Windows.
- Custom channels are now supported. It is now possible to create custom channel factories and channels.
- Peer trust certificate authentication is now supported.
- Windows authentication with explicit credentials is now supported by NetTcp transport in addition to HTTP transport.
- Support is added for communicating with WCF service using identity headers of type SPN, UPN, DNS or X509Certificate.
- ETW tracing is now supported. ETW events can be written to event log.
WCF Connected Service
The WCF Connected Service Preview is a Visual Studio 2015 extension to assist WCF client proxy generation of service reference in .NET Core & ASP.NET Core libraries/applications. It has been updated to support .NET Core 1.1 & ASP.NET Core 1.1.
Known Issues
- Message level security is not supported (#3, #4, #8)
- SpnEndpointIdentity are not supported (#11)
- Windows authentication is not supported by NetTcp transport on UWP (#1235)
- Windows authentication is not supported by Http transport on Linux and OS X (#946)
For a complete list of known issues, please see this issue list.
WCF for .NET Core 1.1 Preview1
Release Notes
This is part of .NET Core 1.1 Preview1 released 10/24/2016 (Release Notes)
Packages
- System.ServiceModel.Duplex 4.3.0-preview1-24610-02
- System.ServiceModel.Http 4.3.0-preview1-24610-02
- System.ServiceModel.NetTcp 4.3.0-preview1-24610-02
- System.ServiceModel.Primitives 4.3.0-preview1-24610-02
- System.ServiceModel.Security 4.3.0-preview1-24610-02
What's New
- Improved performance when calling a service using a synchronous channel during times of thread starvation in the threadpool.
- WebSocket is now supported on Linux and OS X in addition to Windows.
- Custom channels are now supported. It is now possible to create custom channel factories and channels.
- Peer trust certificate authentication is now supported.
- Windows authentication with explicit credentials is now supported by NetTcp transport in addition to HTTP transport.
- Support is added for communicating with WCF service using identity headers of type SPN, UPN, DNS or X509Certificate.
- ETW tracing is now supported. ETW events can be written to event log.
WCF for .NET Core 1.0
Release Notes
This is part of .NET Core 1.0 released 6/27/2016 (Release notes)
Packages
- System.ServiceModel.Duplex 4.0.1
- System.ServiceModel.Http 4.1.0
- System.ServiceModel.NetTcp 4.1.0
- System.ServiceModel.Primitives 4.1.0
- System.ServiceModel.Security 4.0.1
Features
Please refer to the table of Supported Features for a complete list of features that are supported by this release. Here are a few highlights of improvements since RC2 release.
- Performance and reliability improvement
- Significantly increased NetTcp throughput on multi-core machines:
- 2X maximum throughput increase.
- 8X throughput increase in high concurrency scenarios - 20-50% increase in maximum throughput of WebSocket scenarios
- 10-70% increase in maximum throughput of Http based scenarios
- Improved reliability in duplex streaming and handling of state transitions in Http based scenarios
- Improved reliability in Http transport on Linux
- Further streamlined asynchronous code paths to reduce context switches, thread starvation, and latencies
- UWP projects can now leverage latest WCF features in this release by referencing 5.2.2 version of
Microsoft.NETCore.UniversalWindowsPlatform
package. - Client certificates and custom server certificate validation are now supported on Linux and OS X in addition to Windows.
- Client certificates and custom server certificate validation are now supported for NetTcp transport on UWP.
- Client certificates are supported for Http transport on UWP.
- Extended testing on supported platforms including Debian, Fedora, Red Hat Enterprise Linux and Open SUSE in addition to previously known Ubuntu, CentOS, OS X, Windows and UWP.
An update to the WCF Connected Service Preview Visual Studio Extension has been released to assist WCF client proxy generation of service reference for .NET Core 1.0 and ASP.NET Core 1.0 applications.
Known Issues
- Message level security is not supported (#3, #4, #8)
- WebSocket is not supported on Linux or OS X (#625)
- Peer trust certificate authentication is not supported (#1183)
- UpnEndPointIdentity and SpnEndpointIdentity are not supported (#10, #11)
- Windows authentication with explicit credentials is not supported by NetTcp transport (#1262)
- Windows authentication is not supported by NetTcp transport on UWP (#1235)
- Windows authentication is not supported by Http transport on Linux and OS X (#946)
For a complete list of known issues, please see this issue list.
WCF for .NET Core 1.0 RC2
Release notes
This is part of .NET Core 1.0 RC2 released 5/16/2016 (Release notes)
- Supported features
- Please refer to the table of Supported Features for a complete list of features that are supported by this release.
- Packages
- What's new?
- Performance and reliability improvements
- A number of improvements to memory footprint on Http, NetHttp and NetTcp bindings
- Improvements to scalability of asynchronous code paths
- Up to 3X performance improvement in HttpStreaming scenarios
- Significant performance improvement for the first call of a ServiceContract in scenarios where XmlSerializerFormatAttribute and ServiceKnownTypeAttribute are used
- Improved stability in various stress scenarios
- Increased support for HTTPS
- Added the bindings BasicHttpsBinding and NetHttpsBinding
- Added the binding element HttpsTransportBindingElement
- On Windows, a client certificate can be set on the channel factory credentials
- On Windows, a server certificate validation callback can be set on the channel factory credentials
- A client can now specify a client certificate for client authentication with the server or access a certificate provided to the client for validation.
- Added support of all supported TLS/SSL protocols. This brings WCF on .NET Core feature parity with full .NET Framework in the area.
- Added asynchronous support for SSL stream security for improved scalability.
- Added support of Windows stream security (WindowsStreamSecurity binding element) via NegotiateStream. On Windows, support is seamless like for WCF on full .NET Framework. For other OSes, support is available when using Kerberos authentication.
- Added support of MessageHeaderAttribute that allows you to map fields and properties of a type marked with the MessageContractAttribute attribute to SOAP message headers.
- Added support of MessageParameterAttribute that allows you to control the name of the request and response parameter names.
- Added support of setting AllowCookies=true on a channel that allows you to indicates whether a WCF client will automatically store and resend any cookies sent by a WCF service.
- The NetTcp transport now supports all forms of streamed TransferMode (Streamed, StreamedRequest, StreamedResponse). This includes both synchronous and asynchronous forms as well as use with SecurityMode.None and SecurityMode.Transport.
- Performance and reliability improvements
- Known Issues
-
Closing or aborting a client channel using NetTcp can throw a SocketException on OS X. The workaround is to temporarily use a try/catch and ignore SocketExceptions occurring during a close or abort.
-
Client certificates and custom server certificate validation are currently only available on Windows.
-
The support of Kerberos authentication on Linux distros and OS X is dependent on the underlying Kerberos implementation that is MIT GSSAPI (Ubuntu, Debian), NTLM SSP (RedHat / CentOS), or Heimdal (OS X) implementation. In order to establish a connection to the server, one must install required components on corresponding OSes. Additional details can be found in known issues regarding NegotiateStream in .NET Core 1.0 RC2 release notes.
-
In an ASP.NET Core Web Application, a .NET Core Console Application or a .NET Core Class Library, you may need to add
System.Private.ServiceModel
package in addition to WCF contract packages for your application/library to build properly, so your project.json may look like this"netcoreapp1.0": { "imports": "dnxcore50", "dependencies": { ... "System.ServiceModel.Duplex": "4.0.1-rc2-24027", "System.ServiceModel.Http": "4.1.0-rc2-24027", "System.ServiceModel.NetTcp": "4.1.0-rc2-24027", "System.ServiceModel.Primitives": "4.1.0-rc2-24027", "System.ServiceModel.Security": "4.0.1-rc2-24027", "System.Private.ServiceModel": "4.1.0-rc2-24027" } }
-
As stated in the known issues regarding UWP projects in .NET Core 1.0 RC2 release notes, this RC2 release cannot be used in a Windows Universal Platform (UWP) application.
-