Skip to content

Commit

Permalink
Entity Framework Support Policies (#3734)
Browse files Browse the repository at this point in the history
Co-authored-by: Jeremy Likness <Jeremy.Likness@microsoft.com>
  • Loading branch information
ajcvickers and JeremyLikness authored Feb 18, 2022
1 parent 79547e3 commit 7d3da9e
Show file tree
Hide file tree
Showing 3 changed files with 52 additions and 1 deletion.
2 changes: 1 addition & 1 deletion entity-framework/core/what-is-new/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ uid: core/what-is-new/index

See [supported platforms](xref:core/miscellaneous/platforms) for information about the specific platforms supported by each EF Core release.

See the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) for information on support expiration and long-term support (LTS) releases.
Entity Framework Core releases and support are aligned with .NET releases and support. See the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) for information on support expiration and long-term support (LTS) releases.

\* EF Core 2.1 will continue to be supported when used with ASP.NET Core 2.1 on .NET Framework only. See [ASP.NET Support Policy](https://dotnet.microsoft.com/platform/support/policy/aspnet) for details.

Expand Down
49 changes: 49 additions & 0 deletions entity-framework/efcore-and-ef6/support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: Entity Framework Support Policies
description: Support policies for every evolution of Entity Framework
author: ajcvickers
ms.date: 02/16/2022
uid: efcore-and-ef6/support
---

# Entity Framework Support Policies

Entity Framework was first released in 2008 as part of the .NET Framework. Since then it has gone through several evolutions:

- The first version of Entity Framework and Entity Framework 4 are fully contained in the .NET Framework
- Entity Framework 4.1, 4.2, 4.3, and 5.0 have some code in the .NET Framework, and some code shipped as NuGet packages
- Entity Framework 6.0, 6.1, 6.2, 6.3, and 6.4 are shipped entirely as NuGet packages
- Entity Framework Core (all versions) is an entirely separate codebase and ships as NuGet packages

Support policies for each of these variations is described in this document. In all cases, the support policy applies to the latest patch of the given versions.

## Entity Framework Core

New versions of Entity Framework Core are shipped at the same time as new .NET versions. The Entity Framework Core support policy aligns with the [.NET support policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core). See [current and planned releases](xref:core/what-is-new/index) for more information.

Entity Framework Core is the only actively developed version of Entity Framework and we recommend using it for all new code.

## Entity Framework 6.0, 6.1, 6.2, 6.3, and 6.4

Entity Framework 6.x follows the [Modern Lifecycle Policy](/lifecycle/policies/modern). This means that only the latest patch of the latest released version is supported. At this time the latest version is 6.4.4. This version can always [be found on NuGet](https://www.nuget.org/packages/EntityFramework/).
Versions 6.0, 6.1, 6.2, and 6.3 are no longer supported.

Although Entity Framework 6.x is still supported, it is no longer being developed and will only receive fixes for security issues. The Entity Framework 6.x codebase is very stable, and it is a priority to preserve this stability by not making any unnecessary changes to the code. It is strongly encouraged that new applications and existing applications that are in active development [use Entity Framework Core](xref:efcore-and-ef6/index).

Microsoft will provide a minimum of 12 months notification prior to ending support for Entity Framework 6. There are currently no plans to end support.

## Entity Framework 4.1, 4.2, 4.3, and 5.0

> [!WARNING]
> Entity Framework 4.1, 4.2, 4.3, and 5.0 and all patches of these versions are out-of-support and should not be used.
The NuGet packages for Entity Framework 4.1, 4.2, 4.3, and 5.0 are no longer supported. Applications using these versions should be updated to use Entity Framework 6, or [ported to use Entity Framework Core](xref:efcore-and-ef6/porting/index).

Some of the code for Entity Framework 4.x and 5.0 is contained in the .NET Framework. As such, this code is supported as long as [.NET Framework is supported](/lifecycle/products/microsoft-net-framework). However, note that this code is intended to be used in conjunction with the NuGet packages for these Entity Framework versions. The .NET Framework code should not be used independently.

## Entity Framework 1 and 4

> [!WARNING]
> Entity Framework 1 and 4 are considered legacy and should not be used.
The first version of Entity Framework and Entity Framework 4 are fully contained in the .NET Framework. As such, these versions contained in the .NET Framework are supported as a part of the .NET Framework as long as [.NET Framework is supported](/lifecycle/products/microsoft-net-framework). However, only security bugs will be fixed. These versions are legacy code and should not be used.

Applications using these versions should be updated to use Entity Framework 6, or [ported to use Entity Framework Core](xref:efcore-and-ef6/porting/index).
2 changes: 2 additions & 0 deletions entity-framework/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@
items:
- name: EF Core & EF6
items:
- name: Entity Framework Support Policies
href: efcore-and-ef6/support.md
- name: Compare EF Core & EF6
href: efcore-and-ef6/index.md
- name: Port from EF6 to EF Core
Expand Down

0 comments on commit 7d3da9e

Please sign in to comment.