آموزش نصب Entity Framework Core

آموزش نصب Entity Framework Core

Entity Framework Core را می توان با نرم افزارهای توسعه یافته تحت .NET Core و یا .NET 4.6 استفاده کرد. در این بخش به نصب و استفاده از Entity Framework Core 2.0 در یک .NET Core application و با استفاده از Visual Studio 2017 می پردازیم.

از آن جا که EF Core بخشی از .NET Core و standard .NET framework نیست باید آن را بصورت NuGet package نصب کنیم. دو package زیر برای این کار لازم است:

• EF Core DB provider
• EF Core tools

نصب EF Core DB provider

همان طور که قبلا گفتیم، EF Core به ما امکان دسترسی به دیتابیس با استفاده از provider model را می دهد. EF Core DB provider های مختلفی برای دیتابیس های مختلف هست که همه به صورت NuGet packages موجودند.

ابتدا لازم است NuGet packages مربوط به provider مد نظرمان را نصب کنیم. در اینجا می خواهیم به MS SQL Server database متصل شویم، پس Microsoft.EntityFrameworkCore.SqlServer را نصب می کنیم.

برای نصب این package، در Solution Explorer در Visual Studio روی پروژه کلیک راست کنید و Manage NuGet Packages را بزنید (یا از مسیر Tools -> NuGet Package Manager -> Manage NuGet Packages For Solution).

صفحه NuGet Package Manager UI باز می شود. روی Browse یا Updates کلیک کنید و Microsoft.entityframeworkcore را سرچ کنید.

provider package مربوط به دیتابیس مورد نظرتان را انتخاب کنید. در این مثال ما از Microsoft.EntityFrameworkCore.SqlServer برای کار با MS SQL استفاده می کنیم.
در صفحه زیر لیست package هایی که نصب می شوند را می بینید:

در صفحه زیر accept را بزنید:

Microsoft.EntityFrameworkCore.SqlServer package نصب می شود. در پروژه در Dependencies -> NuGet می توانید از نصب آن اطمینان حاصل کنید.

توجه کنید Microsoft.EntityFrameworkCore.Relational و System.Data.SqlClient نیز نصب شده است.

می توانید از طریق Package Manager Console نیز نصب را انجام دهید. از مسیر Tools -> NuGet Package Manager -> Package Manager Console، کنسول را باز کنید و دستور زیر را اجرا کنید:

PM> Install-Package Microsoft.EntityFrameworkCore.SqlServer

نصب EF Core Tools

علاوه بر DB provider package، لازم است برای اجرای دستورات EF Core، EF tools را نصب کنید. نصب آن کمک می کند کارهایی مثل migration ، scaffolding و .. را حین طراحی راحت تر انجام دهید. روش های مختلفی برای نصب این package هست:

1- نصب EF Core Tools از طریق PMC

برای اجرای دستورات EF Core از طریق Package Manager Console، از Nuget UI پکیج Microsoft.EntityFrameworkCore.Tools را سرچ و نصب کنید.

پس از این می توانید دستورات EF Core برای scaffolding، migration و ... مستقیم از Package Manager Console درون VS اجرا کنید.

2- نصب EF Core Tools از طریق dotnet CLI

برای اجرای دستورات EF Core از .NET Core CLI ابتدا با NuGet UI، پکیج Microsoft.EntityFrameworkCore.Tools.DotNet را نصب کنید.

پس از آن، فایل < projectname>.csproj. را ویرایش کنید. نود < DotNetCliToolReference> را به شکل زیر به این فایل اضافه کنید. این مرحله ی اضافه ای است که باید برای اجرای دستورات EF Core 2.0 از طریق dotnet CLI در VS2017 انجام دهید.

< Project Sdk="Microsoft.NET.Sdk">
  < PropertyGroup>
    < OutputType>Exe< /OutputType>
    < TargetFramework>netcoreapp2.0< /TargetFramework>
  < /PropertyGroup>
  < ItemGroup>
    < PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="2.0.0" />
    < PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="2.0.0" />
    < DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />
  < /ItemGroup>
< /Project>

حال CMD را از درون root folder پروژه تان باز کنید و دستورات EF Core را با شروع به صورت dotnet ef، اجرا کنید.

در این بخش توانستیم پکیج های لازم برای EF Core 2.0 را نصب کنیم.