Merge pull request #7883 from rainersigwald/patch-11

MSBuild: RAR IgnoreTargetFrameworkAttributeVersionMismatch

Author: ghogen

docs/msbuild/resolveassemblyreference-task.md

@@ -54,6 +54,7 @@ Determines all assemblies that depend on the specified assemblies, including sec
 |`FullTargetFrameworkSubsetNames`|Optional `String[]` parameter.<br /><br /> Contains a list of target framework subset names. If a subset name in the list matches one in the `TargetFrameworkSubset` name property, then the system excludes that particular target framework subset at build time.|
 |`IgnoreDefaultInstalledAssemblyTables`|Optional `Boolean` parameter.<br /><br /> If `true`, then the task searches for and uses additional installed assembly tables (or, "Redist Lists") that are found in the *\RedistList* directory under `TargetFrameworkDirectories`. The default value is `false.`|
 |`IgnoreDefaultInstalledAssemblySubsetTables`|Optional `Boolean` parameter.<br /><br /> If `true`, then the task searches for and uses additional installed assembly subset tables (or, "Subset Lists") that are found in the *\SubsetList* directory under `TargetFrameworkDirectories`. The default value is `false.`|
+ |`IgnoreTargetFrameworkAttributeVersionMismatch `|Optional `Boolean` parameter.<br /><br /> If `true`, then the task will resolve assemblies that target a higher .NET Framework version than the current project. The default value is `false`, which will skip those references.|
 |`InstalledAssemblySubsetTables`|Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Contains a list of XML files that specify the assemblies that are expected to be in the target subset.<br /><br /> As an option, items in this list can specify the "FrameworkDirectory" metadata to associate an `InstalledAssemblySubsetTable`<br /><br /> with a particular framework directory.<br /><br /> If there is only one `TargetFrameworkDirectories` element, then any items in this list that lack the "FrameworkDirectory" metadata are treated as though they are set to the unique value that is passed to `TargetFrameworkDirectories`.|
 |`InstalledAssemblyTables`|Optional `String` parameter.<br /><br /> Contains a list of XML files that specify the assemblies that are expected to be installed on the target computer.<br /><br /> When `InstalledAssemblyTables` is set, earlier versions of the assemblies in the list are merged into the newer versions that are listed in the XML. Also, assemblies that have a setting of InGAC='true' are considered prerequisites and are set to CopyLocal='false' unless explicitly overridden.<br /><br /> As an option, items in this list can specify "FrameworkDirectory" metadata to associate an `InstalledAssemblyTable` with a particular framework directory.  However, this setting is ignored unless the Redist name begins with<br /><br /> "Microsoft-Windows-CLRCoreComp".<br /><br /> If there is only one `TargetFrameworkDirectories` element, then any items in this list that lack the "FrameworkDirectory" metadata are treated as if they are set to the unique value that is passed<br /><br /> to `TargetFrameworkDirectories`.|
 |`LatestTargetFrameworkDirectories`|Optional `String[]` parameter.<br /><br /> Specifies a list of directories that contain the redist lists for the most current framework that can be targeted on the machine. If this is not set, then the highest framework installed on the machine for a given target framework identifier is used.|