ToolLocationHelper.GetAssemblyFoldersExInfo Method

Definition

Namespace:

Microsoft.Build.Utilities

Assembly:

Microsoft.Build.Utilities.Core.dll

Package:

Microsoft.Build.Utilities.Core v17.9.5

Get a sorted list of AssemblyFoldersExInfo which contain information about what directories the 3rd party assemblies are registered under for use during build and design time.

This method will enumerate the AssemblyFoldersEx registry location and return a list of AssemblyFoldersExInfo in the same order in which they will be searched during both design and build time for reference assemblies.

public:
 static System::Collections::Generic::IList<Microsoft::Build::Utilities::AssemblyFoldersExInfo ^> ^ GetAssemblyFoldersExInfo(System::String ^ registryRoot, System::String ^ targetFrameworkVersion, System::String ^ registryKeySuffix, System::String ^ osVersion, System::String ^ platform, System::Reflection::ProcessorArchitecture targetProcessorArchitecture);

public static System.Collections.Generic.IList<Microsoft.Build.Utilities.AssemblyFoldersExInfo> GetAssemblyFoldersExInfo (string registryRoot, string targetFrameworkVersion, string registryKeySuffix, string osVersion, string platform, System.Reflection.ProcessorArchitecture targetProcessorArchitecture);

static member GetAssemblyFoldersExInfo : string * string * string * string * string * System.Reflection.ProcessorArchitecture -> System.Collections.Generic.IList<Microsoft.Build.Utilities.AssemblyFoldersExInfo>

Public Shared Function GetAssemblyFoldersExInfo (registryRoot As String, targetFrameworkVersion As String, registryKeySuffix As String, osVersion As String, platform As String, targetProcessorArchitecture As ProcessorArchitecture) As IList(Of AssemblyFoldersExInfo)

Parameters

registryRoot

String

The root registry location for the targeted framework. For .NET this is SOFTWARE\MICROSOFT.NETFramework

targetFrameworkVersion

String

The targeted framework version (2.0, 3.0, 3.5, 4.0, etc)

registryKeySuffix

String

The name of the folder (AssemblyFoldersEx) could also be PocketPC\AssemblyFoldersEx, or others

osVersion

String

Components may declare Min and Max OSVersions in the registry this value can be used filter directories returned based on whether or not the osversion is bounded by the Min and Max versions declared by the component. If this value is blank or null no filtering is done

platform

String

Components may declare platform guids in the registry this can be used to return only directories which have a certain platform guid. If this value is blank or null no filtering is done

targetProcessorArchitecture

ProcessorArchitecture

What processor architecture is being targeted. This determines which registry hives are searched in what order. On a 64 bit operating system we do the following If you are targeting 64 bit (target x64 or ia64) Add in the 64 bit hive first Add in the 32 bit hive second If you are not targeting a 64 bit Add in the 32 bit hive first Add in the 64 bit hive second On a 32 bit machine we only add in the 32 bit hive.

Returns

IList<AssemblyFoldersExInfo>

List of AssemblyFoldersExInfo

Remarks

This method enumerates the AssemblyFoldersEx registry location and returns the list of AssemblyFoldersExInfo in the same order that they are searched for reference assemblies at design and build time.

On a 64-bit operating system, if targeting 64-bit, add in the 64-bit hive then the 32-bit hive; if targeting 32-bit, add in the 32-bit hive then the 64-bit hive. On 32-bit machine only add in the 32-bit hive.