We are now in the final stages of bug fixing for EF6 and are pleased to announce the availability of EF6 Release Candidate.
Getting Started with RC
The runtime is available on NuGet. If you are using Code First then there is no need to install the tooling. Follow the instructions on our Get It page for installing the latest pre-release version of Entity Framework runtime.
The tooling for Visual Studio 2012 is available on the Microsoft Download Center. If you are using the Visual Studio 2013 Preview, you can upgrade to the EF6 RC runtime and the tooling included in the preview will continue to work. You only need to install the tooling if you want to use Model First or Database First.
Note: In some cases you may need to update your EF5 code to work with EF6, seeUpdating Applications to use EF6.
Uninstalling RC Tooling in Visual Studio 2012
When you install the RC tooling it will replace the EF Designer that was included in Visual Studio 2012. To revert back to the tooling that was included with Visual Studio 2012 follow these steps.
- Using Add/Remove Programs, uninstall Entity Framework 6 Tools RC1 for Visual Studio 2012
- Repair your Visual Studio 2012 install
- To verify the repair, ensure that Entity Framework Designer for Visual Studio 2012 is listed in the installed programs list
What's Changed Since Beta 1
The following features and changes have been implemented since Beta 1:
- Interception/SQL logging provides low-level building blocks for interception of EF operations with simple SQL logging built on top. We've created a feature specification for this feature and Arthur Vickers has created a multi-part blog series covering this feature.
- Testability improvements make it easier to create test doubles for DbContext and DbSet. We’ve created walkthroughs showing how to take advantage of these changesusing a mocking framework or writing your own test doubles.
- Extensive API changes as a result of polishing the design and implementation of new features. In particular, there have been significant changes in Custom Code First Conventions and Code-Based Configuration. We’ve updated the feature specs and walkthroughs to reflect these changes.
- EF Designer now supports EF6 in projects targeting .NET Framework 4. This limitation from EF6 Beta 1 has now been removed.
Support
This is a preview of features that will be available in the final release of EF6 and is designed to allow you to try out the new features and report any issues you encounter. It is not intended or licensed for use in production.
If you need assistance using the new features, please post questions on Stack Overflow using the entity-framework tag.
What's Next
RC contains all the features we are planning to implement for the EF6 release. We’ve also finished polishing the API surface, adding intellisense documentation, and everything else it takes to finish a release. Between RC and the final release we’ll just be fixing any bugs that come up.
The final release of EF6 will be made available at the same time as Visual Studio 2013 – later this year.
Because we’re pretty much locked down for EF6 we aren’t accepting pull requests for this release. But our master branch is ready to start accepting changes for the next release. We don’t know what the next release will be yet, but probably EF6.1 or EF6.0.1. If you want to try out the latest changes from our master branch - keeping in mind that some of the changes won’t be in EF6 – you can use the latest signed nightly build.
You can also follow us on Twitter and Facebook to stay up to date with what our team is working on.
What Else is New in EF6
This is the complete list of new features in EF6.
Tooling
Our focus with the tooling has been on adding EF6 support and enabling us to easily ship out-of-band between releases of Visual Studio.
The tooling itself does not include any new features, but most of the new runtime features can be used with models created in the EF Designer.
Runtime
The following features work for models created with Code First or the EF Designer:
- Async Query and Save adds support for the task-based asynchronous patterns that were introduced in .NET 4.5. We've created a walkthrough and a feature specification for this feature.
- Connection Resiliency enables automatic recovery from transient connection failures. The feature specification shows how to enable this feature and how to create your own retry policies.
- Code-Based Configuration gives you the option of performing configuration – that was traditionally performed in a config file – in code. We've created an overview with some examples and a feature specification.
- Dependency Resolution introduces support for the Service Locator pattern and we've factored out some pieces of functionality that can be replaced with custom implementations. We’ve created a feature specification and a list of services that can be injected.
- Interception/SQL logging provides low-level building blocks for interception of EF operations with simple SQL logging built on top. We've created a feature specification for this feature and Arthur Vickers has created a multi-part blog series covering this feature.
- Testability improvements make it easier to create test doubles for DbContext and DbSet. We’ve created walkthroughs showing how to take advantage of these changes using a mocking framework or writing your own test doubles.
- Enums, Spatial and Better Performance on .NET 4.0 - By moving the core components that used to be in the .NET Framework into the EF NuGet package we are now able to offer enum support, spatial data types and the performance improvements from EF5 on .NET 4.0.
- DbContext can now be created with a DbConnection that is already opened which enables scenarios where it would be helpful if the connection could be open when creating the context (such as sharing a connection between components where you can not guarantee the state of the connection).
- Default transaction isolation level is changed to READ_COMMITTED_SNAPSHOT for databases created using Code First, potentially allowing for more scalability and fewer deadlocks.
- DbContext.Database.UseTransaction and DbContext.Database.BeginTransaction are new APIs that enable scenarios where you need to manage your own transactions.
- Improved performance of Enumerable.Contains in LINQ queries.
- Significantly improved warm up time (view generation) – especially for large models – as the result of a contributions from AlirezaHaghshenas and VSavenkov.
- Pluggable Pluralization & Singularization Service was contributed by UnaiZorrilla.
- Improved Transaction Support updates the Entity Framework to provide support for a transaction external to the framework as well as improved ways of creating a transaction within the Framework. See this feature specification for details.
- Entity and complex types can now be nestedinside classes.
- Custom implementations of Equals or GetHashCode on entity classes are now supported. See the feature specification for more details.
- DbSet.AddRange/RemoveRange were contributed by UnaiZorrilla and provides an optimized way to add or remove multiple entities from a set.
- DbChangeTracker.HasChanges was contributed by UnaiZorrilla and provides an easy and efficient way to see if there are any pending changes to be saved to the database.
- SqlCeFunctions was contributed by ErikEJ and provides a SQL Compact equivalent to the SqlFunctions.
The following features apply to Code First only:
- Custom Code First Conventions allow write your own conventions to help avoid repetitive configuration. We provide a simple API for lightweight conventions as well as some more complex building blocks to allow you to author more complicated conventions. We’ve created a walkthough and a feature specification for this feature.
- Code First Mapping to Insert/Update/Delete Stored Procedures is now supported. We’ve created a feature specification for this feature.
- Idempotent migrations scripts allow you to generate a SQL script that can upgrade a database at any version up to the latest version. The generated script includes logic to check the __MigrationsHistory table and only apply changes that haven't been previously applied. Use the following command to generate an idempotent script.
Update-Database -Script -SourceMigration $InitialDatabase
- Configurable Migrations History Table allows you to customize the definition of the migrations history table. This is particularly useful for database providers that require the appropriate data types etc. to be specified for the Migrations History table to work correctly. We’ve created a feature specification for this feature.
- Multiple Contexts per Database removes the previous limitation of one Code First model per database when using Migrations or when Code First automatically created the database for you. We’ve created a feature specification for this feature.
- DbModelBuilder.HasDefaultSchema is a new Code First API that allows the default database schema for a Code First model to be configured in one place. Previously the Code First default schema was hard-coded to "dbo" and the only way to configure the schema to which a table belonged was via the ToTable API.
- DbModelBuilder.Configurations.AddFromAssembly method was contributed by UnaiZorrilla. If you are using configuration classes with the Code First Fluent API, this method allows you to easily add all configuration classes defined in an assembly.
- Custom Migrations Operations were enabled by a contribution from iceclow and this blog post provides an example of using this new feature.