NuGet.Frameworks

AssetTargetFallbackFramework only fallback when zero assets are selected. These do not auto fallback during GetNearest as FallbackFramework would.

List framework to fall back to.

Root project framework.

Create a FallbackFramework from the current AssetTargetFallbackFramework.

Sorts frameworks according to the framework mappings

A case insensitive compare of the framework, version, and profile

A case insensitive compare of the framework name only

Sorts NuGet Frameworks in a consistent way for package readers. The order is not particularly useful here beyond making things deterministic since it compares completely different frameworks.

Internal cache key used to store framework compatibility.

Check if the frameworks are compatible.

Project framework Other framework to check against the project framework True if framework supports other

Actual compatibility check without caching

Find all equivalent frameworks, and their equivalent frameworks. Example: Mappings: A <‒> B B <‒> C C <‒> D For A we need to find B, C, and D so we must retrieve equivalent frameworks for A, B, and C also as we discover them.

Creates a table of compatible frameworks.

True if the framework is in the table.

Gives the smallest set of frameworks from the table that cover everything the given framework would cover.

Returns the list of all frameworks compatible with the given framework

Singleton instance of the default framework mappings.

Contains the standard portable framework mappings

Static instance of the portable framework mappings

Get a list of frameworks supporting the provided framework. This list is not meant to be exhaustive but is instead meant to be human-readable. Ex: netstandard1.5 -> netstandardapp1.5, net462, dnxcore50, ...

Ex: IsCompatible(net45, net40) -> true Ex: IsCompatible(net40, net45) -> false

Project target framework Library framework that is going to be installed True if framework supports other

A raw list of framework mappings. These are indexed by the framework name provider and in most cases all mappings are mirrored so that the IFrameworkMappings implementation only needs to provide the minimum amount of mappings.

Synonym ‒> Identifier Ex: NET Framework ‒> .NET Framework

Ex: .NET Framework ‒> net

Ex: WindowsPhone ‒> wp

Equal frameworks. Used for legacy conversions. ex: Framework: Win8 <‒> Framework: NetCore45 Platform: Win8

Framework, EquivalentProfile1, EquivalentProfile2 Ex: Silverlight, WindowsPhone71, WindowsPhone

Frameworks which are subsets of others. Ex: .NETCore ‒> .NET Everything in .NETCore maps to .NET and is one way compatible. Version numbers follow the same format.

Additional framework compatibility rules beyond name and version matching. Ex: .NETFramework supports ‒> Native

Ordered list of framework identifiers. The first framework in the list will be preferred over other framework identifiers. This is enable better tie breaking in scenarios where legacy frameworks are equivalently compatible to a new framework. Example: UAP10.0 ‒> win81, wpa81

Same as but is only referred to if all of the packages in consideration are package based (determined by ).

Only used to choose between frameworks that are equivalent. This favors more human-readable target frameworks identifiers.

Rewrite folder short names to the given value. Ex: dotnet50 ‒> dotnet

Rewrite full framework names to the given value. Ex: .NETPlatform,Version=v0.0 ‒> .NETPlatform,Version=v5.0

Returns the official framework identifier for an alias or short name.

Gives the short name used for folders in NuGet

Get the official profile name from the short name.

Returns the shortened version of the profile name.

Parses a version string using single digit rules if no dots exist

Parses a version string. If no dots exist, all digits are treated as semver-major, instead of inserting dots.

Returns a shortened version. If all digits are single digits no dots will be used.

Tries to parse the portable profile number out of a profile.

Looks up the portable profile number based on the framework list.

Returns the frameworks based on a portable profile number.

Returns the frameworks based on a profile string. Profile can be either the number in format: Profile=7, or the shortened NuGet version: net45+win8

Parses a shortened portable framework profile list. Ex: net45+win8

Returns ranges of frameworks that are known to be supported by the given portable profile number. Ex: Profile7 -> netstandard1.1

Returns a list of all possible substitutions where the framework name have equivalents. Ex: sl3 -> wp8

Gives all substitutions for a framework range.

Returns ranges of frameworks that are known to be supported by the given framework. Ex: net45 -> native

Returns all sub sets of the given framework. Ex: .NETFramework -> .NETCore These will have the same version, but a different framework

The ascending order of frameworks should be based on the following ordered groups: 1. Non-package-based frameworks in . 2. Other non-package-based frameworks. 3. Package-based frameworks in . 4. Other package-based frameworks. For group #1 and #3, the order within the group is based on the order of the respective precedence list. For group #2 and #4, the order is the original order in the incoming list. This should later be made consistent between different input orderings by using the .

netcore50 is a special case since netcore451 is not packages based, but netcore50 is. This sort will treat all versions of netcore as non-packages based.

Used to pick between two equivalent frameworks. This is meant to favor the more human-readable framework. Note that this comparison does not validate that the provided frameworks are indeed equivalent (e.g. with ).

Returns folder short names rewrites. Ex: dotnet50 -> dotnet

Returns full name rewrites. Ex: .NETPlatform,Version=v0.0 -> .NETPlatform,Version=v5.0

Returns all versions of .NETStandard in ascending order.

Returns a list of frameworks that could be compatible with .NETStandard.

A group or object that is specific to a single target framework

Target framework

Ex: 5 -> net4, win8

Additional optional frameworks supported in a portable profile. Ex: 5 -> MonoAndroid1+MonoTouch1

Compatibility mapping for portable profiles. This is a separate compatibility from that in .

Represents a framework that behaves as 2 potentially independent frameworks. Ex. C++/CLI can support both .NET 5.0 and native. This type is immutable.

The root framework. Any compatibility checks should be performed against this framework first.

The secondary framework. If the root framework compatibility checks fail, then the compat checks should be performed against this framework next.

Multiple compatbility

Root framework. Never . Secondary framework. Never . if either or are .

Create a FallbackFramework from the current DualCompatibilityFramework.

List framework to fall back to.

Interned frameworks that are commonly used in NuGet

net11 (.NETFramework,Version=v1.1)

net20 (.NETFramework,Version=v2.0)

net35 (.NETFramework,Version=v3.5)

net40 (.NETFramework,Version=v4.0)

net403 (.NETFramework,Version=v4.0.3)

net45 (.NETFramework,Version=v4.5)

net451 (.NETFramework,Version=v4.5.1)

net452 (.NETFramework,Version=v4.5.2)

net46 (.NETFramework,Version=v4.6)

net461 (.NETFramework,Version=v4.6.1)

net462 (.NETFramework,Version=v4.6.2)

net463 (.NETFramework,Version=v4.6.3)

net47 (.NETFramework,Version=v4.7)

net471 (.NETFramework,Version=v4.7.1)

net472 (.NETFramework,Version=v4.7.2)

net48 (.NETFramework,Version=v4.8)

net481 (.NETFramework,Version=v4.8.1)

netcore45 (.NETCore,Version=v4.5)

This is not .NET Core. You are probably looking for netcoreapp.

netcore451 (.NETCore,Version=v4.5.1)

This is not .NET Core. You are probably looking for netcoreapp.

netcore50 (.NETCore,Version=v5.0)

This is not .NET 5. You are probably looking for net50 (.NETCoreApp,Version=v5.0)

netstandard1.0 (.NETStandard,Version=v1.0)

netstandard1.1 (.NETStandard,Version=v1.1)

netstandard1.2 (.NETStandard,Version=v1.2)

netstandard1.3 (.NETStandard,Version=v1.3)

netstandard1.4 (.NETStandard,Version=v1.4)

netstandard1.5 (.NETStandard,Version=v1.5)

netstandard1.6 (.NETStandard,Version=v1.6)

netstandard1.7 (.NETStandard,Version=v1.7

netstandard2.0 (.NETStandard,Version=v2.0)

netstandard2.1 (.NETStandard,Version=v2.1)

netcoreapp1.0 (.NETCoreApp,Version=v1.0)

netcoreapp1.1 (.NETCoreApp,Version=v1.1)

netcoreapp2.0 (.NETCoreApp,Version=v2.0)

netcoreapp2.1 (.NETCoreApp,Version=v2.1)

netcoreapp2.2 (.NETCoreApp,Version=v2.2)

netcoreapp3.0 (.NETCoreApp,Version=v3.0)

netcoreapp3.1 (.NETCoreApp,Version=v3.1)

net5.0 (.NETCoreApp,Version=v5.0)

net6.0 (.NETCoreApp,Version=v6.0)

net7.0 (.NETCoreApp,Version=v7.0)

net8.0 (.NETCoreApp,Version=v8.0)

net9.0 (.NETCoreApp,Version=v9.0)

net10.0 (.NETCoreApp,Version=v10.0)

FrameworkExpander finds all equivalent and compatible frameworks for a NuGetFramework

Return all possible equivalent, subset, and known compatible frameworks.

Finds all expansions using the mapping provider

True if the Framework is .NETFramework

Return the item with the target framework nearest the project framework

Legacy frameworks that are allowed to have a single digit for the version number.

Frameworks that must always include a decimal point (period) between numerical parts.

Contains identifier -> identifier Ex: .NET Framework -> .NET Framework Ex: NET Framework -> .NET Framework This includes self mappings.

Converts a key using the mappings, or if the key is already converted, finds the normalized form.

Get all equivalent frameworks including the given framework

2 way per framework profile equivalence

2 way framework equivalence

An inclusive range of frameworks

Minimum Framework

Maximum Framework

Minimum version inclusiveness.

Maximum version inclusiveness.

Framework Identifier of both the Min and Max

True if the framework version falls between the min and max

Reduces a list of frameworks into the smallest set of frameworks required.

Creates a FrameworkReducer using the default framework mappings.

Creates a FrameworkReducer using custom framework mappings.

Returns the nearest matching framework that is compatible.

Project target framework Possible frameworks to narrow down Nearest compatible framework. If no frameworks are compatible null is returned.

Remove duplicates found in the equivalence mappings.

Reduce to the highest framework Ex: net45, net403, net40 -> net45

Reduce to the lowest framework Ex: net45, net403, net40 -> net40

Create lookup of the given PCLs to their actual frameworks

portable-net45+win8 -> net45, win8

Order PCLs when there is no other way to decide.

Sort PCLs using these criteria 1. Lowest number of frameworks (highest surface area) wins first 2. Profile with the highest version numbers wins next 3. String compare is used as a last resort

Immutable.

A keyvalue pair specific to a framework identifier

A portable implementation of the .NET FrameworkName type with added support for NuGet folder names.

Creates a new NuGetFramework instance, with an optional profile (only available for netframework)

Creates a new NuGetFramework instance, with an optional platform and platformVersion (only available for net5.0+)

Target framework

Target framework version

Framework Platform (net5.0+)

Framework Platform Version (net5.0+)

True if the platform is non-empty

True if the profile is non-empty

Target framework profile

The TargetFrameworkMoniker identifier of the current NuGetFramework.

Formatted to a System.Versioning.FrameworkName

The TargetFrameworkMoniker identifier of the current NuGetFramework.

Formatted to a System.Versioning.FrameworkName

The TargetPlatformMoniker identifier of the current NuGetFramework.

Similar to a System.Versioning.FrameworkName, but missing the v at the beginning of the version.

Creates the shortened version of the framework using the default mappings. Ex: net45

Helper that is .NET 5 Era aware to replace identifier when appropriate

Creates the shortened version of the framework using the given mappings.

Portable class library check

True if the framework is packages based. Ex: dotnet, dnxcore, netcoreapp, netstandard, uap, netcore50

True if this framework matches for all versions. Ex: net

True if this framework was invalid or unknown. This framework is only compatible with Any and Agnostic.

True if this framework is non-specific. Always compatible.

True if this is the any framework. Always compatible.

True if this framework is real and not one of the special identifiers.

True if this framework is Net5 or later, until we invent something new.

Full framework comparison of the identifier, version, profile, platform, and platform version

Framework name only comparison.

Frameworks that are packages based across all versions.

An unknown or invalid framework

A framework with no specific target framework. This can be used for content only packages.

A wildcard matching all frameworks

Creates a NuGetFramework from a folder name using the default mappings.

Creates a NuGetFramework from a folder name using the given mappings.

Creates a NuGetFramework from individual components

Creates a NuGetFramework from individual components, using the given mappings. This method may have individual component preference, as described in the remarks.

Profiles and TargetPlatforms can't mix. As such the precedence order is profile over target platforms (TPI, TPV). .NETCoreApp,Version=v5.0 and later do not support profiles. Target Platforms are ignored for any frameworks not supporting them. This allows to handle the old project scenarios where the TargetPlatformIdentifier and TargetPlatformVersion may be set to Windows and v7.0 respectively.

Creates a NuGetFramework from a .NET FrameworkName

Creates a NuGetFramework from a folder name using the default mappings.

Creates a NuGetFramework from a folder name using the given mappings.

Attempt to parse a common but deprecated framework using an exact string match Support for these should be dropped as soon as possible.

A set of special and common frameworks that can be returned from the list of constants without parsing Using the interned frameworks here optimizes comparisons since they can be checked by reference. This is designed to optimize

Find the most compatible group based on target framework

framework specific groups or items project target framework retrieves the framework from the group

Find the most compatible group based on target framework

framework specific groups or items project target framework retrieves the framework from the group framework mappings

Find the most compatible group based on target framework

framework specific groups or items project target framework

Find the most compatible group based on target framework

framework specific groups or items project target framework

Check compatibility with additional checks for the fallback framework.

True if the framework is netcore50 or higher. This is where the framework becomes packages based.

Creates a one way compatibility mapping. Ex: net -supports-> native

Project framework Framework that is supported by the project framework

Primary framework range or project target framework that supports the SuppportedFrameworkRange

Framework range that is supported by the TargetFrameworkRange

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

Looks up a localized string similar to The argument cannot be null or empty..

Looks up a localized string similar to .NET 5.0 and above does not support profiles..

Looks up a localized string similar to Frameworks must have the same identifier, profile, and platform..

Looks up a localized string similar to Invalid framework identifier '{0}'..

Looks up a localized string similar to Invalid framework version '{0}'..

Looks up a localized string similar to Invalid platform version '{0}'..

Looks up a localized string similar to Invalid portable frameworks '{0}'. A hyphen may not be in any of the portable framework names..

Looks up a localized string similar to Invalid portable frameworks for '{0}'. A portable framework must have at least one framework in the profile..

Hash code creator, based on the original NuGet hash code combiner/ASP hash code combiner implementations

Create a unique hash code for the given set of items

Return the enumerable as a List of T, copying if required. Optimized for common case where it is an List of T. Avoid mutating the return value.

https://aspnetwebstack.codeplex.com/SourceControl/latest#src/Common/CollectionExtensions.cs

Return the ISet as a HashSet of T, copying if required. Optimized for common case where it is a HashSet of T. Avoid mutating the return value.

Helper function to append an to a . Calling directly causes an allocation by first converting the to a string and then appending that result:


             public StringBuilder Append(int value)
             {
                 return Append(value.ToString(CultureInfo.CurrentCulture));
             }

Note that this uses the current culture to do the conversion while does not do any cultural sensitive conversion.

The to append to. The to append.

Avoids allocating an enumerator when enumerating an .

Returns a struct-based enumerator that avoids heap allocation during enumeration. If the underlying type is then this method will delegate to , otherwise the collection's items are accessed by index via 's indexer directly. When using a struct-based enumerator, no heap allocation occurs during enumeration via . This is in contrast to the interface-based enumerator which will always be allocated on the heap.


              list = ...;
            
             foreach (string item in list.NoAllocEnumerate())
             {
                 // ...
             }]]>

Provides a struct-based enumerator for use with . Do not use this type directly. Use instead.

A struct-based enumerator for use with . Do not use this type directly. Use instead.

Avoids allocating an enumerator when enumerating an where the concrete type has a well known struct enumerator, such as for , or when index-based access is possible via .

Several collection types (e.g. ) provide a struct-based enumerator type (e.g. ) which the compiler can use in statements. When using a struct-based enumerator, no heap allocation occurs during such enumeration. This is in contrast to the interface-based enumerator which will always be allocated on the heap. This method returns a custom struct enumerator that will avoid any heap allocation if (which is declared via interface ) is actually of known concrete type that provides its own struct enumerator. If so, it delegates to that type's enumerator without any boxing or other heap allocation. If is not of a known concrete type, the returned enumerator falls back to the interface-based enumerator, which will be allocated on the heap. Benchmarking shows the overhead in such cases is low enough to be within the measurement error, meaning this is an inexpensive optimization that won't regress behavior and with low downside for cases where it cannot apply an optimization.


              source = ...;
            
             foreach (string item in source.NoAllocEnumerate())
             {
                 // ...
             }]]>

Provides a struct-based enumerator for use with . Do not use this type directly. Use instead.

A struct-based enumerator for use with . Do not use this type directly. Use instead.

Avoids allocating an enumerator when enumerating an where the concrete type has a well known struct enumerator, such as for .


              dictionary = ...;
            
             foreach ((string key, string value) in dictionary.NoAllocEnumerate())
             {
                 // ...
             }]]>

Provides a struct-based enumerator for use with . Do not use this type directly. Use instead.

A struct-based enumerator for use with . Do not use this type directly. Use instead.

Provides a resource pool that enables reusing instances of instances.

Renting and returning buffers with an can increase performance in situations where instances are created and destroyed frequently, resulting in significant memory pressure on the garbage collector. This class is thread-safe. All members may be used by multiple threads concurrently.

Retrieves a shared instance.

Retrieves a that is at least the requested length.

The minimum capacity of the needed. A that is at least in length. This buffer is loaned to the caller and should be returned to the same pool via so that it may be reused in subsequent usage of . It is not a fatal error to not return a rented string builder, but failure to do so may lead to decreased application performance, as the pool may need to create a new instance to replace the one lost.

Returns to the pool an array that was previously obtained via on the same instance, returning the built string.

The previously obtained from to return to the pool. Once a has been returned to the pool, the caller gives up all ownership of the instance and must not use it. The reference returned from a given call to must only be returned via once. The default may hold onto the returned instance in order to rent it again, or it may release the returned instance if it's determined that the pool already has enough instances stored. The string, built from .

Specifies that null is allowed as an input even if the corresponding type disallows it.

Specifies that null is disallowed as an input even if the corresponding type allows it.

Specifies that an output may be null even if the corresponding type disallows it.

Specifies that an output will not be null even if the corresponding type allows it. Specifies that an input argument was not null when the call returns.

Specifies that when a method returns , the parameter may be null even if the corresponding type disallows it.

Initializes the attribute with the specified return value condition.

The return value condition. If the method returns this value, the associated parameter may be null.

Gets the return value condition.

Specifies that when a method returns , the parameter will not be null even if the corresponding type allows it.

Initializes the attribute with the specified return value condition.

The return value condition. If the method returns this value, the associated parameter will not be null.

Gets the return value condition.

Specifies that the output will be non-null if the named parameter is non-null.

Initializes the attribute with the associated parameter name.

The associated parameter name. The output will be non-null if the argument to the parameter specified is non-null.

Gets the associated parameter name.

Applied to a method that will never return under any circumstance.

Specifies that the method will not return if the associated Boolean parameter is passed the specified value.

Initializes the attribute with the specified parameter value.

The condition parameter value. Code after the method will be considered unreachable by diagnostics if the argument to the associated parameter matches this value.

Gets the condition parameter value.

Specifies that the method or property will ensure that the listed field and property members have not-null values.

Initializes the attribute with a field or property member.

The field or property member that is promised to be not-null.

Initializes the attribute with the list of field and property members.

The list of field and property members that are promised to be not-null.

Gets field or property member names.

Specifies that the method or property will ensure that the listed field and property members have not-null values when returning with the specified return value condition.

Initializes the attribute with the specified return value condition and a field or property member.

The return value condition. If the method returns this value, the associated parameter will not be null. The field or property member that is promised to be not-null.

Initializes the attribute with the specified return value condition and list of field and property members.

The return value condition. If the method returns this value, the associated parameter will not be null. The list of field and property members that are promised to be not-null.

Gets the return value condition.

Gets field or property member names.