Export (0) Print
Expand All

ComponentGuaranteesOptions Enumeration

Describes the compatibility guarantee of a component, type, or type member that may span multiple versions.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  System.Runtime.Versioning
Assembly:  mscorlib (in mscorlib.dll)

public enum ComponentGuaranteesOptions

Member nameDescription
ExchangeThe developer promises multi-version exchange compatibility for the type. Consumers of the type can expect compatibility across future versions and can use the type in all their interfaces. Versioning problems cannot be fixed by side-by-side execution.
NoneThe developer does not guarantee compatibility across versions. Consumers of the component, type, or member can expect future versions to break the existing client.
SideBySideThe component has been tested to work when more than one version of the assembly is loaded into the same application domain. Future versions can break compatibility. However, when such breaking changes are made, the old version is not modified but continues to exist alongside the new version.
StableThe developer promises stable compatibility across versions. Consumers of the type can expect that future versions will not break the existing client. However, if they do and if the client has not used the type in its interfaces, side-by-side execution may fix the problem.

The ComponentGuaranteesOptions enumeration is used by the ComponentGuaranteesAttribute class to indicate the level of compatibility that is guaranteed for a component or class library that spans multiple versions. Exchange provides the strongest compatibility guarantee, followed by Stable and SideBySide. None does not promise compatibility across versions.

For a detailed discussion of the meaning of each guarantee, see the ComponentGuaranteesAttribute topic.

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft