What's new for 4.7.2 #4857

rpetrusha · 2018-04-03T00:40:38Z

What's new for 4.7.2

mairaw

This looks great @rpetrusha. Left a few comments for you to take care of. Links are still broken but I have PR in place for 4.7.2.

mairaw · 2018-04-03T06:53:09Z

docs/framework/whats-new/index.md

+
+**New overloads of RSA.Create and DSA.Create**
+
+The <xref:System.Security.Cryptography.DSA.Create(System.Security.Cryptography.DSAParamteters)?displayProperty=nameWithType> and <xref:System.Security.Cryptography.RSA.Create(System.Security.Cryptography.RSAParamteters)?displayProperty=nameWithType> methods let you supply key parameters when instantiated a new <xref:System.Security.Cryptography.DSA> or <xref:System.Security.Cryptography.RSA> key. They allow you to replace code like the following:


DSAParamteters -> DSAParameters? (same for RSA)

mairaw · 2018-04-03T06:53:42Z

docs/framework/whats-new/index.md

+   - [public static HashSet<TSource> ToHashSet<TSource>(this IEnumerable<TSource> source);](xref:System.Linq.Enumerable.ToHashSet%2A)
+   - [public static HashSet<TSource> ToHashSet<TSource>(this IEnumerable<TSource> source, IEqualityComparer<TSource> comparer);](xref:System.Linq.Enumerable.ToHashSet%2A)
+- New <xref:System.Collections.Generic.HashSet%601> constructors that let you set the collection's capacity, which yields a performance benefit when you know the size of the <xref:System.Collections.Generic.HashSet%601> in advance:
+   - [public HashSet(int capacity)](xref:System.Collections.Generic.HashSet%601.#ctor(System.Int32))


you need to encode # in xref links

mairaw · 2018-04-03T06:56:09Z

docs/framework/whats-new/index.md

+<a name="net472" />
+#### Networking
+
+**Implementation of HttpClientHandler p0roperties**


p0roperties -> properties

mairaw · 2018-04-03T06:59:10Z

docs/framework/whats-new/index.md

+For Windows Forms application, the previous workaround of setting DPI awareness in the application configuration file rather than the application manifest is no longer necessary for ClickOnce deployment to succeed.

+<a name="v471"></a> 
 ### What's new in the .NET Framework 4.7.1


should this be H2 and the one for 4.7? they're not showing up in the nav bar

mairaw · 2018-04-03T06:59:43Z

docs/framework/whats-new/index.md

+
+**Support for Azure Active Directory Universal Authentication and Multi-Factor authentication**
+
+Growing compliance and security demands require that many customers use multi-factor authentication (MFA). In addition, current best practices discourage including user passwords directly in connection strings. To support these changes, the .NET Framework 4.7.2 extends [SQLClient connection strings](xref:System.Data.SqlClient.ConnectionSTring) by adding a new value, "Active Directory Interactive", for the existing "Authentication" keyword to support MFA and [Azure AD Authentication](/azure/sql-database/sql-database-aad-authentication-configure). The new interactive method supports native and federated Azure AD users as well as Azure AD guest users. When this method is used, the MFA authentiation imposed by Azure AD is supported for SQL databases. In addition, the authentication process requests a user password to adhere to security best practices.


authentiation -> authentication

mairaw · 2018-04-03T07:01:25Z

docs/framework/whats-new/index.md

+using (RSA rsa = RSA.Create())
+{
+   rsa.ImportParameters(rsaParameters);
+   // Other code to execute using the rsa instance.


uppercase the algorithm name?

mairaw · 2018-04-03T07:02:21Z

docs/framework/whats-new/index.md

+   // Other code to execute using the rsa instance.
+}
+``` 
+```vb


nit: it's good to separate code blocks from text by using new lines. It renders fine but it's easier to read here.

mairaw · 2018-04-03T07:04:29Z

docs/framework/whats-new/index.md

+
+**Support for ephemeral keys**
+
+PFX import can optionally load private keys directly from memory, bypassing the hard drive. When the new <xref:System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.EphemeralKeySet?displayProperty=nameWithType> flag is specified in an <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> constructor or one of the overloads of the <xref:System.Security.Cryptography.X509Certificates.X509Certificate2.Import%2A?displayProperty=nameWithType> method, the private keys will be loaded as ephemeral keys. This prevents the keys from being visible on the disk. However:


define PFX?

I think I'll leave it undefined, @mairaw.

mairaw · 2018-04-03T07:04:57Z

docs/framework/whats-new/index.md

+End Using
+``` 
+
+The <xref:System.Security.Cryptography.DSA.Create(System.Int32)?displayProperty=nameWithType> and <xref:System.Security.Cryptography.RSA.Create(System.Int32)?displayProperty=nameWithType> methods let you generate new <xref:System.Security.Cryptography.DSA> or <xref:System.Security.Cryptography.RSA> keys with a specific keysize. For example:


keysize -> key size

mairaw · 2018-04-03T07:11:47Z

docs/framework/whats-new/index.md

+
+Starting with the .NET Framework 4.7.2, a diagnostic assistant can locate the owners of a given <xref:Windows.UI.Xaml.ResourceDictionary>. (The feature is for use by diagnostic assistants and not by production applications.) Whenever a change is made to a <xref:Windows.UI.Xaml.ResourceDictionary>, WPF automatically finds all [DynamicResource](../wpf/advanced/dynamicresource-markup-extension.md) references that might be affected by the change. 
+
+A diagnostic assistant such as Visual Studio’s “Edit-and-Continue” facility may want extend this to handle [StaticResource](../wpf/advanced/staticresource-markup-extension.md) references. The first step in this process is to find the owners of the dictionary; that is, to find all the objects whose `Resources` property refers to the dictionary (either directly, or indirectly via the <xref:System.Windows.ResourceDictionary.MergedDictionaries?displayProperty=nameWithType> property). Three new static methods implemented on the <xref:System.Windows.Diagnostics.ResourceDictionaryDiagnostics?displayProperty=nameWithType> class, one for each of the base types that has a `Resources` property,support this step:


nit: add space after last comma

svick · 2018-04-04T10:21:35Z

docs/framework/whats-new/index.md

 # What's new in the .NET Framework
 <a name="introduction"></a>This article summarizes key new features and improvements in the following versions of the .NET Framework:  

+[.NET Framework 4.7.2](#v472)


Missing double space at the end of the line for correct formatting.

svick · 2018-04-04T10:27:49Z

docs/framework/whats-new/index.md

+``` 
+with code like this:
+```csharp
+// Before .NET Framework 4.7.2


I think this should be either "After .NET Framework 4.7.2" or something like "With .NET Framework 4.7.2". The same for VB code below.

Thanks for catching this, @svick.

svick · 2018-04-04T10:33:18Z

docs/framework/whats-new/index.md

+
+**Rfc2898DeriveBytes constructors accept a hash algorithm name**
+
+The <xref:System.Security.Cryptography.Rfc2898DeriveBytes> class has three new constructors with a <xref:System.Security.Cryptography.HashAlgorithmName> parameter that identifies the HMAC algorithm to use when deriving keys. Instead of using SHA-1, developers should use SHA-2-based HMAC, as shown in the following example:


The relationship between SHA-2 mentioned here and HashAlgorithmName.SHA256 in the code below might not be clear. Maybe include a very short note about that? E.g.:

developers should use SHA-2-based HMAC like SHA-256

svick · 2018-04-04T10:54:00Z

docs/framework/whats-new/index.md

+   - [public static HashSet<TSource> ToHashSet<TSource>(this IEnumerable<TSource> source, IEqualityComparer<TSource> comparer);](xref:System.Linq.Enumerable.ToHashSet%2A)
+- New <xref:System.Collections.Generic.HashSet%601> constructors that let you set the collection's capacity, which yields a performance benefit when you know the size of the <xref:System.Collections.Generic.HashSet%601> in advance:
+   - [public HashSet(int capacity)](xref:System.Collections.Generic.HashSet%601.#ctor(System.Int32))
+   - [public HashSet(int capacity, IEqualityComparer<T> comparer)](xref:System.Collections.Generic.HashSet%601.#ctor(System.Int32,System.Collections.Generic.IEqualityComparer%7B%600%7D))  


The formatting of the list of overloads above is not consistent: some start with a `, some end with a ;, some don't. Probably the best option is to use code formatting with `, so that generics are visible.

svick · 2018-04-04T10:55:57Z

docs/framework/whats-new/index.md

+
+- `TryGetValue` methods, which extend the try pattern used in other collection types to these two types. The methods are:
+   - [`public bool HashSet.TryGetValue(T equalValue, out T actualValue);](xref:System.Collections.Generic.SortedSet%601.TryGetValue%2A)
+   - [`public bool SortedSet.TryGetValue(T equalValue, out T actualValue);](xref:System.Collections.Generic.SortedSEt%601.TryGetValue%2A)


I think it would be better to display generics here: e.g. HashSet.TryGetValue → HashSet<T>.TryGetValue.

svick · 2018-04-04T12:56:19Z

docs/framework/whats-new/index.md

+
+- [public static IEnumerable<FrameworkContentElement> GetFrameworkContentElementOwners(ResourceDictionary dictionary);](xref:System.Windows.Diagnostics.ResourceDictionaryDiagnostics.GetFrameworkContentElementOwners%2A)
+
+- [public static IEnumerable<Application> GetApplicationOwners(ResourceDictionary dictionary);](xref:System.Windows.Diagnostics.ResourceDictionaryDiagnostics.GetApplicationOwners%2A)


Similar to before, one of the members starts with `, when I think all should start and end with it.

svick · 2018-04-04T13:41:13Z

docs/framework/whats-new/index.md

+   public ResourceDictionary ResourceDictionary { get; private set; }
+
+   public object ResourceKey { get; private set; }
+}


If this is meant to show just the public API, then I think all the private set; are not necessary. You can just make the properties appear as if they were get-only auto-properties.

svick · 2018-04-04T13:42:03Z

docs/framework/whats-new/index.md

+}
+```
+
+The event is not raised (and its `add` method is ignored) unless <xref:System.Windows.Diagnostics.VisualDiagnostics> is enabled and the [`ENABLE_XAML_DIAGNOSTICS_SOURCE_INFO`](xref:System.Windows.Diagnostics.VisualDiagnostics.GetXamlSourceInfo%2A) environment variable is set.


I think it's more correct to call add an accessor, not a method.

svick · 2018-04-04T13:47:58Z

docs/framework/whats-new/index.md

+```xml
+<windowsSettings>
+      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true</dpiAware>
+    </windowsSettings>


Nit: inconsistent indentation

svick · 2018-04-04T13:48:24Z

docs/framework/whats-new/index.md

+<a name="clickonce472" />
+#### ClickOnce
+
+HDPI-aware applications for Windows Forms, Windows Presentation Foundation (WPF), and Visual Studio Tools for Office (VSTO) can all be deployed by using ClickOnce. If the following entry is found in teh application manifest, deployment will succeed under .NET Framework 4.7.2:


rpetrusha · 2018-04-06T15:26:15Z

Thanks for the thorough review and the comments, @svick! I'll address them in the next round of revisions.

rpetrusha · 2018-04-09T19:12:35Z

Thanks for the reviews, @mairaw and @svick. I've addressed your comments.

What's new for 4.7.2

3023038

rpetrusha requested a review from mairaw April 3, 2018 00:40

mairaw requested changes Apr 3, 2018

View reviewed changes

rpetrusha added this to the Sprint 133 (3/17/18 - 4/06/18) milestone Apr 3, 2018

svick reviewed Apr 4, 2018

View reviewed changes

Interim checkin for a new build

c121e82

Incorporated review comments, fixed links

f1c3f00

rpetrusha changed the title ~~What's new for 4.7.2~~ [WIP] What's new for 4.7.2 Apr 9, 2018

Fixed broken link

9945736

rpetrusha added the 🏁 Release: .NET Framework 4.7.2 label Apr 14, 2018

rpetrusha modified the milestones: Sprint 133 (3/17/18 - 4/6/18) , Sprint 134 (4/7/2018 - 4/27/2018) Apr 16, 2018

rpetrusha added the blocked Blocked for some reason label Apr 21, 2018

mairaw approved these changes Apr 27, 2018

View reviewed changes

corrected fwlink

cd942fc

rpetrusha removed the blocked Blocked for some reason label Apr 30, 2018

rpetrusha changed the title ~~[WIP] What's new for 4.7.2~~ What's new for 4.7.2 Apr 30, 2018

rpetrusha merged commit ab6bf8a into dotnet:master Apr 30, 2018

rpetrusha deleted the whats-new branch April 30, 2018 19:02


		New overloads of RSA.Create and DSA.Create

		The <xref:System.Security.Cryptography.DSA.Create(System.Security.Cryptography.DSAParamteters)?displayProperty=nameWithType> and <xref:System.Security.Cryptography.RSA.Create(System.Security.Cryptography.RSAParamteters)?displayProperty=nameWithType> methods let you supply key parameters when instantiated a new <xref:System.Security.Cryptography.DSA> or <xref:System.Security.Cryptography.RSA> key. They allow you to replace code like the following:


		Support for Azure Active Directory Universal Authentication and Multi-Factor authentication

		Growing compliance and security demands require that many customers use multi-factor authentication (MFA). In addition, current best practices discourage including user passwords directly in connection strings. To support these changes, the .NET Framework 4.7.2 extends [SQLClient connection strings](xref:System.Data.SqlClient.ConnectionSTring) by adding a new value, "Active Directory Interactive", for the existing "Authentication" keyword to support MFA and [Azure AD Authentication](/azure/sql-database/sql-database-aad-authentication-configure). The new interactive method supports native and federated Azure AD users as well as Azure AD guest users. When this method is used, the MFA authentiation imposed by Azure AD is supported for SQL databases. In addition, the authentication process requests a user password to adhere to security best practices.


		Support for ephemeral keys

		PFX import can optionally load private keys directly from memory, bypassing the hard drive. When the new <xref:System.Security.Cryptography.X509Certificates.X509KeyStorageFlags.EphemeralKeySet?displayProperty=nameWithType> flag is specified in an <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> constructor or one of the overloads of the <xref:System.Security.Cryptography.X509Certificates.X509Certificate2.Import%2A?displayProperty=nameWithType> method, the private keys will be loaded as ephemeral keys. This prevents the keys from being visible on the disk. However:


		Starting with the .NET Framework 4.7.2, a diagnostic assistant can locate the owners of a given <xref:Windows.UI.Xaml.ResourceDictionary>. (The feature is for use by diagnostic assistants and not by production applications.) Whenever a change is made to a <xref:Windows.UI.Xaml.ResourceDictionary>, WPF automatically finds all [DynamicResource](../wpf/advanced/dynamicresource-markup-extension.md) references that might be affected by the change.

		A diagnostic assistant such as Visual Studio’s “Edit-and-Continue” facility may want extend this to handle [StaticResource](../wpf/advanced/staticresource-markup-extension.md) references. The first step in this process is to find the owners of the dictionary; that is, to find all the objects whose `Resources` property refers to the dictionary (either directly, or indirectly via the <xref:System.Windows.ResourceDictionary.MergedDictionaries?displayProperty=nameWithType> property). Three new static methods implemented on the <xref:System.Windows.Diagnostics.ResourceDictionaryDiagnostics?displayProperty=nameWithType> class, one for each of the base types that has a `Resources` property,support this step:


		Rfc2898DeriveBytes constructors accept a hash algorithm name

		The <xref:System.Security.Cryptography.Rfc2898DeriveBytes> class has three new constructors with a <xref:System.Security.Cryptography.HashAlgorithmName> parameter that identifies the HMAC algorithm to use when deriving keys. Instead of using SHA-1, developers should use SHA-2-based HMAC, as shown in the following example:


		- [public static IEnumerable<FrameworkContentElement> GetFrameworkContentElementOwners(ResourceDictionary dictionary);](xref:System.Windows.Diagnostics.ResourceDictionaryDiagnostics.GetFrameworkContentElementOwners%2A)

		- [public static IEnumerable<Application> GetApplicationOwners(ResourceDictionary dictionary);](xref:System.Windows.Diagnostics.ResourceDictionaryDiagnostics.GetApplicationOwners%2A)

What's new for 4.7.2 #4857

What's new for 4.7.2 #4857

Uh oh!

Conversation

rpetrusha commented Apr 3, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What's new for 4.7.2

Uh oh!

mairaw left a comment

Choose a reason for hiding this comment

Uh oh!

mairaw Apr 3, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

svick Apr 4, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rpetrusha commented Apr 6, 2018

Uh oh!

rpetrusha commented Apr 9, 2018

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

rpetrusha commented Apr 3, 2018 •

edited

Loading

mairaw Apr 3, 2018 •

edited

Loading

svick Apr 4, 2018 •

edited

Loading