|
| 1 | +# Release Notes |
| 2 | + |
| 3 | +## Microsoft.Data.SqlClient 2.0.0-preview3.20122.2 released 1 May 2020 |
| 4 | + |
| 5 | +This update brings the below changes over the previous release: |
| 6 | + |
| 7 | +### Added |
| 8 | +- Allow passing username with Active Directory Interactive Authentication in .NET Framework [#492](https://github.com/dotnet/SqlClient/pull/492) |
| 9 | +- Allow large UDT buffers for .NET Framework [#456](https://github.com/dotnet/SqlClient/pull/456) |
| 10 | +- Added "Transaction Id" and "Client Version" in Diagnostic Source traces [#515](https://github.com/dotnet/SqlClient/pull/515) |
| 11 | +- Added new `SqlConnectionOverrides` APIs to perform `SqlConnection.Open()` with fail fast option [#463](https://github.com/dotnet/SqlClient/pull/463) |
| 12 | + |
| 13 | +### Fixed |
| 14 | +- Addressed MARS TDS Header errors by reverting changes to make `SqlDataReader.ReadAsync()` non-blocking [#547](https://github.com/dotnet/SqlClient/pull/547) |
| 15 | +- Fixed driver behavior to not perform enlistment of pooled connection in aborted transaction [#543](https://github.com/dotnet/SqlClient/pull/543) |
| 16 | +- Fixed wrong application domain selected when starting `SqlDependencyListener` [#410](https://github.com/dotnet/SqlClient/pull/410) |
| 17 | +- Added missing refs for `RowCopied` property in `SqlBulkCopy` [#508](https://github.com/dotnet/SqlClient/pull/508) |
| 18 | + |
| 19 | +### Changes |
| 20 | +- Improved performance by removing unwanted method calls in Event Source tracing [#506](https://github.com/dotnet/SqlClient/pull/506) |
| 21 | +- Removed Diagnostic Source and Configuration Manager dependencies from .NET Standard implementation [#535](https://github.com/dotnet/SqlClient/pull/535) |
| 22 | +- Removed redundant calls to `DbConnectionPoolKey.GetType()` [#512](https://github.com/dotnet/SqlClient/pull/512) |
| 23 | + |
| 24 | +### Breaking Changes |
| 25 | +- Updated driver to perform decimal scale rounding to match SQL Server behavior [#470](https://github.com/dotnet/SqlClient/pull/470) |
| 26 | +- Standardized App Context switch that enables Managed SNI on Windows for .NET Core and .NET Standard (break only applies to 2.0 preview releases that introduced the switch) [#548](https://github.com/dotnet/SqlClient/pull/548) |
| 27 | + |
| 28 | + |
| 29 | +### Enabling decimal truncation behavior conditionally |
| 30 | +Starting with v2.0.0-preview3, the decimal data scale will be rounded by the driver by default as is done by SQL Server. |
| 31 | +For backwards compatibility, you can set the [AppContext](https://docs.microsoft.com/en-us/dotnet/api/system.appcontext?view=netframework-4.8) switch "Switch.Microsoft.Data.SqlClient.TruncateScaledDecimal" to "true". |
| 32 | + |
| 33 | +To set the switch at application startup, specify: |
| 34 | + |
| 35 | +```cs |
| 36 | +AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.TruncateScaledDecimal", true); |
| 37 | +``` |
| 38 | + |
| 39 | +### Enabling Managed networking on Windows |
| 40 | +This release introduces the renamed AppContext switch "Switch.Microsoft.Data.SqlClient.UseManagedNetworkingOnWindows" that enables the use of Managed SNI instead of native SNI on Windows for testing and debugging purposes. This switch will toggle the driver's behavior to use Managed SNI in .NET Core 2.1+ and .NET Standard 2.0+ projects on Windows. |
| 41 | + |
| 42 | +To set the switch at application startup, specify: |
| 43 | + |
| 44 | +```cs |
| 45 | +AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.UseManagedNetworkingOnWindows", true); |
| 46 | +``` |
| 47 | + |
| 48 | +## Target Platform Support |
| 49 | + |
| 50 | +- .NET Framework 4.6+ |
| 51 | +- .NET Core 2.1+ (Windows x86, Windows x64, Linux, macOS) |
| 52 | +- .NET Standard 2.0+ (Windows x86, Windows x64, Linux, macOS) |
| 53 | + |
| 54 | +### Dependencies |
| 55 | + |
| 56 | +#### .NET Framework |
| 57 | + |
| 58 | +- Microsoft.Data.SqlClient.SNI 1.1.0+ |
| 59 | +- Microsoft.Identity.Client 3.0.8 |
| 60 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 5.6.0 |
| 61 | +- Microsoft.IdentityModel.JsonWebTokens 5.6.0 |
| 62 | + |
| 63 | +#### .NET Core 2.1 |
| 64 | + |
| 65 | +- runtime.native.System.Data.SqlClient.sni 4.4.0 |
| 66 | +- Microsoft.Win32.Registry 4.7.0 |
| 67 | +- System.Security.Principal.Windows 4.7.0 |
| 68 | +- System.Text.Encoding.CodePages 4.7.0 |
| 69 | +- System.Diagnostics.DiagnosticSource 4.7.0 |
| 70 | +- System.Configuration.ConfigurationManager 4.7.0 |
| 71 | +- System.Runtime.Caching 4.7.0 |
| 72 | +- Microsoft.Identity.Client 4.7.1 |
| 73 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 5.6.0 |
| 74 | +- Microsoft.IdentityModel.JsonWebTokens 5.6.0 |
| 75 | + |
| 76 | +#### .NET Core 3.1 |
| 77 | + |
| 78 | +- runtime.native.System.Data.SqlClient.sni 4.4.0 |
| 79 | +- Microsoft.Win32.Registry 4.7.0 |
| 80 | +- System.Security.Principal.Windows 4.7.0 |
| 81 | +- System.Text.Encoding.CodePages 4.7.0 |
| 82 | +- System.Diagnostics.DiagnosticSource 4.7.0 |
| 83 | +- System.Configuration.ConfigurationManager 4.7.0 |
| 84 | +- System.Runtime.Caching 4.7.0 |
| 85 | +- Microsoft.Identity.Client 4.7.1 |
| 86 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 5.6.0 |
| 87 | +- Microsoft.IdentityModel.JsonWebTokens 5.6.0 |
| 88 | + |
| 89 | +#### .NET Standard |
| 90 | + |
| 91 | +- runtime.native.System.Data.SqlClient.sni 4.4.0 |
| 92 | +- Microsoft.Win32.Registry 4.7.0 |
| 93 | +- System.Buffers 4.5.0 |
| 94 | +- System.Memory 4.5.3 |
| 95 | +- System.Security.Principal.Windows 4.7.0 |
| 96 | +- System.Text.Encoding.CodePages 4.7.0 |
| 97 | +- Microsoft.Identity.Client 4.7.1 |
| 98 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 5.6.0 |
| 99 | +- Microsoft.IdentityModel.JsonWebTokens 5.6.0 |
0 commit comments