ToolLocationHelper.GetPathToStandardLibraries Method

Reference

Definition

Namespace:: Microsoft.Build.Utilities

Assembly:: Microsoft.Build.Utilities.Core.dll

Assembly:: Microsoft.Build.Utilities.v4.0.dll

Package:: Microsoft.Build.Utilities.Core v15.9.20

Package:: Microsoft.Build.Utilities.Core v16.11.0

Package:: Microsoft.Build.Utilities.Core v17.9.5

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns the path to the reference assemblies location for the given target framework's standard libraries (that is, mscorlib).

Overloads

GetPathToStandardLibraries(String, String, String, String, String, String)	Returns the path to mscorlib and system.dll
GetPathToStandardLibraries(String, String, String, String, String)	Returns the path to mscorlib and system.dll
GetPathToStandardLibraries(String, String, String)	Returns the path to the reference assemblies location for the given target framework's standard libraries (i.e. mscorlib). This method will assume the requested ReferenceAssemblyRoot path will be the ProgramFiles directory specified by Environment.SpecialFolder.ProgramFiles In additon when the .NETFramework or .NET Framework targetFrameworkIdentifiers are seen and targetFrameworkVersion is 2.0, 3.0, 3.5 or 4.0 we will return the correctly chained reference assembly paths for the legacy .net frameworks. This chaining will use the existing GetPathToDotNetFrameworkReferenceAssemblies to build up the list of reference assembly paths.
GetPathToStandardLibraries(String, String, String, String)	Returns the path to mscorlib and system.dll

Remarks

This method assumes the requested ReferenceAssemblyRoot path is the ProgramFiles directory specified by Environment.SpecialFolder.ProgramFiles. In addition, when the .NETFramework or .NET Framework targetFrameworkIdentifiers are seen and targetFrameworkVersion is 2.0, 3.0, 3.5, or 4.0, it returns the correctly chained reference assembly paths for the legacy .NET Framework versions. This chaining uses the existing GetPathToDotNetFrameworkReferenceAssemblies to build up the list of reference assembly paths

GetPathToStandardLibraries(String, String, String, String, String, String)

Returns the path to mscorlib and system.dll

public:
 static System::String ^ GetPathToStandardLibraries(System::String ^ targetFrameworkIdentifier, System::String ^ targetFrameworkVersion, System::String ^ targetFrameworkProfile, System::String ^ platformTarget, System::String ^ targetFrameworkRootPath, System::String ^ targetFrameworkFallbackSearchPaths);

public static string GetPathToStandardLibraries (string targetFrameworkIdentifier, string targetFrameworkVersion, string targetFrameworkProfile, string platformTarget, string targetFrameworkRootPath, string targetFrameworkFallbackSearchPaths);

static member GetPathToStandardLibraries : string * string * string * string * string * string -> string

Public Shared Function GetPathToStandardLibraries (targetFrameworkIdentifier As String, targetFrameworkVersion As String, targetFrameworkProfile As String, platformTarget As String, targetFrameworkRootPath As String, targetFrameworkFallbackSearchPaths As String) As String

Parameters

targetFrameworkIdentifier: String

Identifier being targeted

targetFrameworkVersion: String

Version being targeted

targetFrameworkProfile: String

Profile being targeted

platformTarget: String

What is the targeted platform, this is used to determine where we should look for the standard libraries. Note, this parameter is only used for .net frameworks less than 4.0

targetFrameworkRootPath: String

Root directory where the target framework will be looked for. Uses default path if this is null

targetFrameworkFallbackSearchPaths: String

';' separated list of paths that are looked up if the framework cannot be found in @targetFrameworkRootPath

Returns

String

Collection of reference assembly locations.

Exceptions

ArgumentNullException

When the frameworkName is null

Applies to

GetPathToStandardLibraries(String, String, String, String, String)

Returns the path to mscorlib and system.dll

public:
 static System::String ^ GetPathToStandardLibraries(System::String ^ targetFrameworkIdentifier, System::String ^ targetFrameworkVersion, System::String ^ targetFrameworkProfile, System::String ^ platformTarget, System::String ^ targetFrameworkRootPath);

public static string GetPathToStandardLibraries (string targetFrameworkIdentifier, string targetFrameworkVersion, string targetFrameworkProfile, string platformTarget, string targetFrameworkRootPath);

static member GetPathToStandardLibraries : string * string * string * string * string -> string

Public Shared Function GetPathToStandardLibraries (targetFrameworkIdentifier As String, targetFrameworkVersion As String, targetFrameworkProfile As String, platformTarget As String, targetFrameworkRootPath As String) As String

Parameters

targetFrameworkIdentifier: String

Identifier being targeted

targetFrameworkVersion: String

Version being targeted

targetFrameworkProfile: String

Profile being targeted

platformTarget: String

What is the targeted platform, this is used to determine where we should look for the standard libraries. Note, this parameter is only used for .net frameworks less than 4.0

targetFrameworkRootPath: String

Root directory where the target framework will be looked for. Uses default path if this is null

Returns

String

Collection of reference assembly locations.

Exceptions

ArgumentNullException

When the frameworkName is null

Applies to

GetPathToStandardLibraries(String, String, String)

Returns the path to the reference assemblies location for the given target framework's standard libraries (i.e. mscorlib). This method will assume the requested ReferenceAssemblyRoot path will be the ProgramFiles directory specified by Environment.SpecialFolder.ProgramFiles In additon when the .NETFramework or .NET Framework targetFrameworkIdentifiers are seen and targetFrameworkVersion is 2.0, 3.0, 3.5 or 4.0 we will return the correctly chained reference assembly paths for the legacy .net frameworks. This chaining will use the existing GetPathToDotNetFrameworkReferenceAssemblies to build up the list of reference assembly paths.

public:
 static System::String ^ GetPathToStandardLibraries(System::String ^ targetFrameworkIdentifier, System::String ^ targetFrameworkVersion, System::String ^ targetFrameworkProfile);

public static string GetPathToStandardLibraries (string targetFrameworkIdentifier, string targetFrameworkVersion, string targetFrameworkProfile);

static member GetPathToStandardLibraries : string * string * string -> string

Public Shared Function GetPathToStandardLibraries (targetFrameworkIdentifier As String, targetFrameworkVersion As String, targetFrameworkProfile As String) As String

Parameters

targetFrameworkIdentifier: String

Identifier being targeted

targetFrameworkVersion: String

Version being targeted

targetFrameworkProfile: String

Profile being targeted

Returns

String

Collection of reference assembly locations.

Exceptions

ArgumentNullException

When the frameworkName is null

Applies to

GetPathToStandardLibraries(String, String, String, String)

Returns the path to mscorlib and system.dll

public:
 static System::String ^ GetPathToStandardLibraries(System::String ^ targetFrameworkIdentifier, System::String ^ targetFrameworkVersion, System::String ^ targetFrameworkProfile, System::String ^ platformTarget);

public static string GetPathToStandardLibraries (string targetFrameworkIdentifier, string targetFrameworkVersion, string targetFrameworkProfile, string platformTarget);

static member GetPathToStandardLibraries : string * string * string * string -> string

Public Shared Function GetPathToStandardLibraries (targetFrameworkIdentifier As String, targetFrameworkVersion As String, targetFrameworkProfile As String, platformTarget As String) As String

Parameters

targetFrameworkIdentifier: String

Identifier being targeted

targetFrameworkVersion: String

Version being targeted

targetFrameworkProfile: String

Profile being targeted

platformTarget: String

What is the targeted platform, this is used to determine where we should look for the standard libraries. Note, this parameter is only used for .net frameworks less than 4.0

Returns

String

Collection of reference assembly locations.

Exceptions

ArgumentNullException

When the frameworkName is null

Applies to

ToolLocationHelper.GetPathToStandardLibraries Method

Definition

Overloads

Remarks

GetPathToStandardLibraries(String, String, String, String, String, String)

Parameters

Returns

Exceptions

Applies to

GetPathToStandardLibraries(String, String, String, String, String)

Parameters

Returns

Exceptions

Applies to

GetPathToStandardLibraries(String, String, String)

Parameters

Returns

Exceptions

Applies to

GetPathToStandardLibraries(String, String, String, String)

Parameters

Returns

Exceptions

Applies to

Additional resources