Release notes for 1.0 hotfix 2 (dotnet#223)

David-Engel · web-flow · commit 7110cc321234 · 2019-09-26T14:16:51.000-07:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,10 +1,21 @@
 # Changelog
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
+## [Hotfix & Stable Release 1.0.19269.1] - 2019-09-26
+
+### Fixed Issues
+
+- `SqlCommand.StatementCompleted` event never being fired [#212](https://github.com/dotnet/SqlClient/issues/212)
+- Added missing `Authentication` property to `SqlConnectionStringBuilder` reference assembly
+- Reverted API changes in `SqlAuthenticationParameters` which had changed the `public string Resource` property to `public string[] Scopes`
+
 ## [Hotfix & Stable Release 1.0.19249.1] - 2019-09-06
+
 ### Fixed Issues
+
 - Fixed issues with large data reading in Unix applications when data is spanned over multiple packets. [#171](https://github.com/dotnet/SqlClient/pull/171)
 
 ## [Stable Release 1.0.19239.1] - 2019-08-27
diff --git a/README.md b/README.md
@@ -4,17 +4,19 @@
 
 # Microsoft SqlClient Data Provider for SQL Server
 
-Welcome to the home of Microsoft ADO.NET driver for SQL Server aka Microsoft.Data.SqlClient GitHub repository.
+Welcome to the home of Microsoft ADO.NET driver for SQL Server aka the Microsoft.Data.SqlClient GitHub repository.
 
 Microsoft.Data.SqlClient is a data provider for Microsoft Sql Server. Now in General Availability, it is a union of the two System.Data.SqlClient components which live independently in .NET Framework and .NET Core. Going forward, support for new SQL Server features will be implemented in Microsoft.Data.SqlClient.
 
 ## Supportability
-The Microsoft.Data.SqlClient package supports below environments:
+
+The Microsoft.Data.SqlClient package supports the below environments:
+
 - .NET Framework 4.6+
 - .NET Core 2.1+
 - .NET Standard 2.0+.
 
-The source code of this library is now available under MIT license.
+The source code of this library is now available under the MIT license.
 
 ## Download
 
diff --git a/release-notes/1.0/1.0.19249.1.md b/release-notes/1.0/1.0.19249.1.md
@@ -1,61 +1,62 @@
 # Release Notes
 
-## Hotfix & Stable release Microsoft.Data.SqlClient 1.0.192349.1 released 6 September 2019
+## Hotfix & Stable release Microsoft.Data.SqlClient 1.0.19249.1 released 6 September 2019
 
 This update brings the below changes over the previous stable release [v1.0.19239.1](1.0.19239.1.md):
 
 ### Fixed
+
 - Fixed issues with large data reading in Unix applications when data is spanned over multiple packets. [#171](https://github.com/dotnet/SqlClient/pull/171)
 
 ### Target Platform Support
 
-* .NET Framework 4.6+
-* .NET Core 2.1+ (Windows x86, Windows x64, Linux, macOS)
-* .NET Standard 2.0+ (Windows x86, Windows x64, Linux, macOS)
+- .NET Framework 4.6+
+- .NET Core 2.1+ (Windows x86, Windows x64, Linux, macOS)
+- .NET Standard 2.0+ (Windows x86, Windows x64, Linux, macOS)
 
 ### Dependencies
 
 #### .NET Framework
 
-* System.Data.Common 4.3.0
-* Microsoft.Data.SqlClient.SNI 1.0.19235.1
-* Microsoft.Identity.Client 3.0.8
+- System.Data.Common 4.3.0
+- Microsoft.Data.SqlClient.SNI 1.0.19235.1
+- Microsoft.Identity.Client 3.0.8
 
 #### .NET Core
 
-* Microsoft.Win32.Registry 4.5.0
-* runtime.native.System.Data.SqlClient.sni 4.4.0
-* System.Security.Principal.Windows 4.5.0
-* System.Text.Encoding.CodePages 4.5.0
-* System.Configuration.ConfigurationManager 4.5.0
-* Microsoft.Identity.Client 3.0.8
+- Microsoft.Win32.Registry 4.5.0
+- runtime.native.System.Data.SqlClient.sni 4.4.0
+- System.Security.Principal.Windows 4.5.0
+- System.Text.Encoding.CodePages 4.5.0
+- System.Configuration.ConfigurationManager 4.5.0
+- Microsoft.Identity.Client 3.0.8
 
 #### .NET Standard
 
-* Microsoft.Win32.Registry 4.5.0
-* runtime.native.System.Data.SqlClient.sni 4.4.0
-* System.Buffers 4.4.0
-* System.Diagnostics.DiagnosticSource 4.5.0
-* System.Memory 4.5.1
-* System.Security.Principal.Windows 4.5.0
-* System.Text.Encoding.CodePages 4.5.0
-* System.Configuration.ConfigurationManager 4.5.0
-* Microsoft.Identity.Client 3.0.8
+- Microsoft.Win32.Registry 4.5.0
+- runtime.native.System.Data.SqlClient.sni 4.4.0
+- System.Buffers 4.4.0
+- System.Diagnostics.DiagnosticSource 4.5.0
+- System.Memory 4.5.1
+- System.Security.Principal.Windows 4.5.0
+- System.Text.Encoding.CodePages 4.5.0
+- System.Configuration.ConfigurationManager 4.5.0
+- Microsoft.Identity.Client 3.0.8
 
 ### New Features
 
 #### New features over .NET Framework 4.7.2 System.Data.SqlClient
 
-* [Active Directory Interactive Authentication](#active-directory-interactive-authentication-(In-.net-framework)) - Applicable to Azure SQL Database and Azure Data Warehouse
-* [Data Classification](#data-classification) - Available in Azure SQL Database and Microsoft SQL Server 2019 since CTP 2.0.
-* [UTF-8 support](#utf-8-support) - Available in Microsoft SQL Server SQL Server 2019 since CTP 2.3.
+- [Active Directory Interactive Authentication](#active-directory-interactive-authentication-(In-.net-framework)) - Applicable to Azure SQL Database and Azure Data Warehouse
+- [Data Classification](#data-classification) - Available in Azure SQL Database and Microsoft SQL Server 2019 since CTP 2.0.
+- [UTF-8 support](#utf-8-support) - Available in Microsoft SQL Server SQL Server 2019 since CTP 2.3.
 
 #### New features over .NET Core 2.2 System.Data.SqlClient
 
-* [Active Directory Password Authentication](#active-directory-password-authentication-(in-.net-core)) - Applicable to Azure SQL Database and Azure Data Warehouse
-* [Data Classification](#data-classification) - Available in Azure SQL Database and Microsoft SQL Server 2019 since CTP 2.0.
-* [UTF-8 support](#utf-8-support) - Available in Microsoft SQL Server SQL Server 2019 since CTP 2.3.
-* [Always Encrypted](#always-encrypted) - Always Encrypted is available in Microsoft SQL Server 2016 and higher.
+- [Active Directory Password Authentication](#active-directory-password-authentication-(in-.net-core)) - Applicable to Azure SQL Database and Azure Data Warehouse
+- [Data Classification](#data-classification) - Available in Azure SQL Database and Microsoft SQL Server 2019 since CTP 2.0.
+- [UTF-8 support](#utf-8-support) - Available in Microsoft SQL Server SQL Server 2019 since CTP 2.3.
+- [Always Encrypted](#always-encrypted) - Always Encrypted is available in Microsoft SQL Server 2016 and higher.
 
 ### Active Directory Interactive Authentication (In .NET Framework)
 
@@ -132,15 +133,15 @@ UTF-8 support does not require any application code changes. These SqlClient cha
 
 In general, existing documentation which uses System.Data.SqlClient on .NET Framework **and built-in column master key store providers** should now work with .NET Core, too.
 
-* [Develop using Always Encrypted with .NET Framework Data Provider](https://docs.microsoft.com/sql/relational-databases/security/encryption/develop-using-always-encrypted-with-net-framework-data-provider?view=sql-server-2017)
-* [Always Encrypted: Protect sensitive data and store encryption keys in the Windows certificate store](https://docs.microsoft.com/azure/sql-database/sql-database-always-encrypted)
+- [Develop using Always Encrypted with .NET Framework Data Provider](https://docs.microsoft.com/sql/relational-databases/security/encryption/develop-using-always-encrypted-with-net-framework-data-provider?view=sql-server-2017)
+- [Always Encrypted: Protect sensitive data and store encryption keys in the Windows certificate store](https://docs.microsoft.com/azure/sql-database/sql-database-always-encrypted)
 
 ### Known Issues
 
-* User Data Types (UDTs) may not work with Microsoft.Data.SqlClient.
+- User Data Types (UDTs) may not work with Microsoft.Data.SqlClient.
 
 **Notes:**
 
-* There is no key store provider for Azure Key Vault and Microsoft.Data.SqlClient at this time.
-* Always Encrypted with secure enclaves is not supported with Microsoft.Data.SqlClient.
-* Always Encrypted is only supported against .NET Framework and .NET Core targets. It is not supported against .NET Standard since .NET Standard is missing certain encryption dependencies.
+- There is no key store provider for Azure Key Vault and Microsoft.Data.SqlClient at this time.
+- Always Encrypted with secure enclaves is not supported with Microsoft.Data.SqlClient.
+- Always Encrypted is only supported against .NET Framework and .NET Core targets. It is not supported against .NET Standard since .NET Standard is missing certain encryption dependencies.
diff --git a/release-notes/1.0/1.0.19269.1.md b/release-notes/1.0/1.0.19269.1.md
@@ -0,0 +1,149 @@
+# Release Notes
+
+## Hotfix & Stable release Microsoft.Data.SqlClient 1.0.19269.1 released 26 September 2019
+
+This update brings the below changes over the previous stable release [v1.0.19249.1](1.0.19249.1.md):
+
+### Fixed
+
+- `SqlCommand.StatementCompleted` event never being fired [#212](https://github.com/dotnet/SqlClient/issues/212)
+- Added missing `Authentication` property to `SqlConnectionStringBuilder` reference assembly
+- Reverted API changes in `SqlAuthenticationParameters` which had changed the `public string Resource` property to `public string[] Scopes`
+
+### Target Platform Support
+
+- .NET Framework 4.6+
+- .NET Core 2.1+ (Windows x86, Windows x64, Linux, macOS)
+- .NET Standard 2.0+ (Windows x86, Windows x64, Linux, macOS)
+
+### Dependencies
+
+#### .NET Framework
+
+- System.Data.Common 4.3.0
+- Microsoft.Data.SqlClient.SNI 1.0.19235.1
+- Microsoft.Identity.Client 3.0.8
+
+#### .NET Core
+
+- Microsoft.Win32.Registry 4.5.0
+- runtime.native.System.Data.SqlClient.sni 4.4.0
+- System.Security.Principal.Windows 4.5.0
+- System.Text.Encoding.CodePages 4.5.0
+- System.Configuration.ConfigurationManager 4.5.0
+- Microsoft.Identity.Client 3.0.8
+
+#### .NET Standard
+
+- Microsoft.Win32.Registry 4.5.0
+- runtime.native.System.Data.SqlClient.sni 4.4.0
+- System.Buffers 4.4.0
+- System.Diagnostics.DiagnosticSource 4.5.0
+- System.Memory 4.5.1
+- System.Security.Principal.Windows 4.5.0
+- System.Text.Encoding.CodePages 4.5.0
+- System.Configuration.ConfigurationManager 4.5.0
+- Microsoft.Identity.Client 3.0.8
+
+### New Features
+
+#### New features over .NET Framework 4.7.2 System.Data.SqlClient
+
+- [Active Directory Interactive Authentication](#active-directory-interactive-authentication-(In-.net-framework)) - Applicable to Azure SQL Database and Azure Data Warehouse
+- [Data Classification](#data-classification) - Available in Azure SQL Database and Microsoft SQL Server 2019 since CTP 2.0.
+- [UTF-8 support](#utf-8-support) - Available in Microsoft SQL Server SQL Server 2019 since CTP 2.3.
+
+#### New features over .NET Core 2.2 System.Data.SqlClient
+
+- [Active Directory Password Authentication](#active-directory-password-authentication-(in-.net-core)) - Applicable to Azure SQL Database and Azure Data Warehouse
+- [Data Classification](#data-classification) - Available in Azure SQL Database and Microsoft SQL Server 2019 since CTP 2.0.
+- [UTF-8 support](#utf-8-support) - Available in Microsoft SQL Server SQL Server 2019 since CTP 2.3.
+- [Always Encrypted](#always-encrypted) - Always Encrypted is available in Microsoft SQL Server 2016 and higher.
+
+### Active Directory Interactive Authentication (In .NET Framework)
+
+Microsoft.Data.SqlClient now supports "**Interactive Authentication with Azure Active Directory (AAD)**" for .NET Framework applications, also known as "*Multi-factor AAD authentication*" and "*Active Directory Universal Authentication*". Azure MFA helps safeguard access to data and applications while meeting user demand for a simple sign-in process. It delivers strong authentication with a range of easy verification options (phone call, text message, smart cards with pin, or mobile app notification), allowing users to choose the method they prefer. Interactive MFA with Azure AD can result in a pop-up dialog box for validation.
+
+To connect to a database using Interactive Authentication mode and an Azure AD identity, the `Authentication` keyword in the database connection string must be set to `Active Directory Interactive`. An example to connect using this mode of authentication is below:
+
+```C#
+string ConnectionString =
+@"Data Source=n9lxnyuzhv.database.windows.net; Authentication=Active Directory Interactive; Initial Catalog=testdb;";
+using (SqlConnection conn = new SqlConnection(ConnectionString)) {
+    conn.Open();
+}
+```
+
+### Active Directory Password Authentication (In .NET Core)
+Microsoft.Data.SqlClient now supports "**Azure Active Directory (AAD) Password Authentication**" for .NET Core applications. This authentication mode supports authentication to Azure SQL DB/DW with Azure AD for native or federated Azure AD users.
+
+To connect to a database using AD Password Authentication mode and an Azure AD identity, the `Authentication` keyword in the database connection string must be set to `Active Directory Password` and user credentials must be provided. An example to connect using this mode of authentication is below:
+
+```C#
+string ConnectionString =
+@"Data Source=n9lxnyuzhv.database.windows.net; Authentication=Active Directory Password; Initial Catalog=testdb;UID=user@domain.com;PWD=***";
+using (SqlConnection conn = new SqlConnection(ConnectionString)) {
+    conn.Open();
+}
+```
+
+### Data Classification
+
+Data Classification brings a new set of APIs exposing read-only Data Sensitivity and Classification information about objects retrieved via SqlDataReader when the underlying source supports the feature and contains metadata about [data sensitivity and classification](https://docs.microsoft.com/sql/relational-databases/security/sql-data-discovery-and-classification?view=sql-server-2017):
+
+```C#
+public class SqlDataReader
+{
+    public Microsoft.Data.SqlClient.DataClassification.SensitivityClassification SensitivityClassification
+}
+
+namespace Microsoft.Data.SqlClient.DataClassification
+{
+    public class ColumnSensitivity
+    {
+        public System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.Data.SqlClient.DataClassification.SensitivityProperty> SensitivityProperties
+    }
+    public class InformationType
+    {
+        public string Id
+        public string Name
+    }
+    public class Label
+    {
+        public string Id
+        public string Name
+    }
+    public class SensitivityClassification
+    {
+        public System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.Data.SqlClient.DataClassification.ColumnSensitivity> ColumnSensitivities
+        public System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.Data.SqlClient.DataClassification.InformationType> InformationTypes
+        public System.Collections.ObjectModel.ReadOnlyCollection<Microsoft.Data.SqlClient.DataClassification.Label> Labels
+    }
+    public class SensitivityProperty
+    {
+        public Microsoft.Data.SqlClient.DataClassification.InformationType InformationType
+        public Microsoft.Data.SqlClient.DataClassification.Label Label
+    }
+}
+```
+
+### UTF-8 Support
+
+UTF-8 support does not require any application code changes. These SqlClient changes simply optimize the communication between the client and server when the server supports UTF-8 and the underlying column collation is UTF-8. See the UTF-8 section under [What's new in SQL Server 2019 preview](https://docs.microsoft.com/sql/sql-server/what-s-new-in-sql-server-ver15?view=sqlallproducts-allversions#utf-8-support-ctp-23).
+
+### Always Encrypted
+
+In general, existing documentation which uses System.Data.SqlClient on .NET Framework **and built-in column master key store providers** should now work with .NET Core, too.
+
+- [Develop using Always Encrypted with .NET Framework Data Provider](https://docs.microsoft.com/sql/relational-databases/security/encryption/develop-using-always-encrypted-with-net-framework-data-provider?view=sql-server-2017)
+- [Always Encrypted: Protect sensitive data and store encryption keys in the Windows certificate store](https://docs.microsoft.com/azure/sql-database/sql-database-always-encrypted)
+
+### Known Issues
+
+- User Data Types (UDTs) may not work with Microsoft.Data.SqlClient.
+
+**Notes:**
+
+- There is no key store provider for Azure Key Vault and Microsoft.Data.SqlClient at this time.
+- Always Encrypted with secure enclaves is not supported with Microsoft.Data.SqlClient.
+- Always Encrypted is only supported against .NET Framework and .NET Core targets. It is not supported against .NET Standard since .NET Standard is missing certain encryption dependencies.
diff --git a/release-notes/1.0/1.0.md b/release-notes/1.0/1.0.md
@@ -4,6 +4,7 @@ The following Microsoft.Data.SqlClient 1.0 stable releases have been shipped:
 
 | Release Date | Description | Notes |
 | :-- | :-- | :--: |
+| 2019/09/26 | 1.0.19269.1  | [release notes](1.0.19269.1.md) |
 | 2019/09/06 | 1.0.19249.1  | [release notes](1.0.19249.1.md) |
 | 2019/08/27 | 1.0.19239.1  | [release notes](1.0.19239.1.md) |
 
diff --git a/release-notes/1.0/README.md b/release-notes/1.0/README.md
@@ -4,6 +4,7 @@ The following Microsoft.Data.SqlClient 1.0 stable releases have been shipped:
 
 | Release Date | Description | Notes |
 | :-- | :-- | :--: |
+| 2019/09/26 | 1.0.19269.1  | [release notes](1.0.19269.1.md) |
 | 2019/09/06 | 1.0.19249.1  | [release notes](1.0.19249.1.md) |
 | 2019/08/27 | 1.0.19239.1  | [release notes](1.0.19239.1.md) |
 
diff --git a/release-notes/README.md b/release-notes/README.md
@@ -4,4 +4,4 @@ The latest release is [Microsoft.Data.SqlClient 1.0](1.0).
 
 ## Release Information
 
-* [Microsoft.Data.SqlClient 1.0](1.0)
+- [Microsoft.Data.SqlClient 1.0](1.0)

Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,4 @@ The latest release is [Microsoft.Data.SqlClient 1.0](1.0).`
`4`	`4`
`5`	`5`	`## Release Information`
`6`	`6`
`7`		`-* [Microsoft.Data.SqlClient 1.0](1.0)`
	`7`	`+- [Microsoft.Data.SqlClient 1.0](1.0)`