WindowsでASP.NET Core+SQLiteの開発環境をつくる

オウルです。

今回は、ASP.NET Core 3.1 MVC アプリの開発環境を Windows に準備します。

※ WSL Ubuntu 版は、こちらを参考にしてください。

WSL UbuntuでASP.NET Core+SQLiteの開発環境のをつくる

https://book2525stack.com/2020/01/15/linux-netcore-development-env

オウルです。今回は、ASP.NET Core 3.1 MVC アプリの開発環境を WSL Ubuntu に準備します。※ Windows 版は、こちらを参考にしてください。RDBMS は本業で SQLServer を１０年近く使用しているため、SQLServer でと考えていましたが、SQL Server on Linux を動作させるためのマシンのメモリが、最低２ＧＢ要求されるため、今回は SQLite を使用します。WSL Ubuntu 開発環境を構築ローカル環境Client OSWindows10WSLUbuntu 18.04.2 LTSEditorVisual Studio CodeSDKASP.NET Core 3.1RDBMSSQLite 3.22.0WSL Ubuntu 18.04.2 LTS インストー...

RDBMS は本業で SQLServer を１０年近く使用しているため、SQLServer でと考えていましたが、SQL Server on Linux を動作させるためのマシンのメモリが、最低２ＧＢ要求されるため、今回は SQLite を使用します。

Windows 開発環境を構築

ローカル環境

OS	Windows10
IDE	Visual Studio 2019 v16.4～
SDK	ASP.NET Core 3.1
RDBMS	SQLite 3.30.1

.NET Core 3.1 SDK インストール

Download .NET Core 3.1 から、SDK をダウンロードして、インストールします。

SQLite CommandLine Tools インストール

SQLite Download Page から、sqlite-tools-win32-x86-3300100.zip をダウンロードして、任意の場所に展開します。CLI を使いやすいようにパスを通しておきましょう。

:: バージョンを確認
sqlite3 -version
3.30.1 2019-10-10 20:19:45 18db032d058f1436ce3d～

:: バージョンを確認

sqlite3 -version

3.30.1 2019-10-10 20:19:45 18db032d058f1436ce3d～

ASP.NET Core MVC プロジェクトの作成

プロジェクト作成の手順が分からない場合は、次の記事を参考にしてください。

雲の上はいつも晴れ

【初心者向け】はじめての ASP.NET Core 作りながら学習（2）- プロジェクト作成

https://book2525stack.com/2019/03/30/beginner-aspnetcore-2

オウルです。「はじめての ASP.NET Core 作りながら学習」の第２回目となります。前回の記事はこちらをご覧ください。今回は、 Visual Studio 2019 RC を使って ASP.NET Core プロジェクトを作成します。プログラミング初心者の方は、途中で分からない単語などでてくるかと思いますが、手を止めず ASP.NET Core プロジェクトを作成を進めてください。もしかして分からないかなと僕が予想した内容については、最後にリファレンス情報を載せているので参考にしてください。初めて見聞きする単語が、たくさん出てきて意識があっちこっち行...

ASP.NET Core 3.1 の要件

Visual Studio 2019 でASP.NET Core 3.1 を使用する場合には v16.4 以上である必要があります。要件を満たしていない場合は、「ヘルプ / 更新プログラムの確認」より Visual Studio 2019 をアップデートしてください。また、このアップデートは、OS 再起動を求められます。

SQLite パッケージインストール

NuGetパッケージマネジャーより、次のパッケージをインストールします。

Microsoft.EntityFrameworkCore.Sqlite

NLog パッケージインストール

ASP.NET Core では、組み込みやサードパーティ製のさまざまなログプロバイダーと連携するログ API がサポートされています。公式ページにはログプロバイダーの一覧があります。その中で便利な NLog を使用します。

NLog の設定方法は、Getting started with ASP.NET Core 3 を参考にしてください。

ASP.NET Core 2.x の NLog は、次の記事にまとめています。

雲の上はいつも晴れ

【初心者向け】はじめての ASP.NET Core 作りながら学習（4）- NLog

https://book2525stack.com/2019/05/09/beginner-aspnetcore-nlog

オウルです。前回のIntelliCode編の続きです。今回はアプリケーション開発において重要なログです。ASP.NET Core では、組み込みやサードパーティ製のさまざまなログプロバイダーと連携するログ API がサポートされています。公式ページにはログプロバイダーの一覧がありますよ。「はじめての ASP.NET Core 作りながら学習」では、その中で便利な NLog を使用します。公式：サードパーティ製のログプロバイダーの一覧NLogNLogとはNLog is a flexible and free logging platform for various .NET platforms, including .NET standard...

Startup.cs

SQLite を使用するように、Startup.cs を変更します。

public void ConfigureServices(IServiceCollection services)
{
	services.AddDbContext<ApplicationDbContext>(options =>
		options.UseSqlite(
			Configuration.GetConnectionString("DefaultConnection")));
	services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = false)
		.AddEntityFrameworkStores<ApplicationDbContext>();
	services.AddControllersWithViews();
	services.AddRazorPages();
}

public void ConfigureServices(IServiceCollection services)

{

services.AddDbContext<ApplicationDbContext>(options =>

options.UseSqlite(

Configuration.GetConnectionString("DefaultConnection")));

services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = false)

.AddEntityFrameworkStores<ApplicationDbContext>();

services.AddControllersWithViews();

services.AddRazorPages();

}

appsettings.json

SQLite を使用するように、”DefaultConnection” を変更します。

"ConnectionStrings": {
    "DefaultConnection": "Data Source=app.db"
},

"ConnectionStrings": {

"DefaultConnection": "Data Source=app.db"

マイグレーション

Visual Studio のパッケージマネジャーコンソールからプロジェクトファイルがあるフォルダに移動して、次のコマンドを実行します。

dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet ef migrations add InitialCreate
dotnet ef database update

dotnet tool install --global dotnet-ef

dotnet add package Microsoft.EntityFrameworkCore.Design

dotnet ef migrations add InitialCreate

dotnet ef database update

”dotnet ef database update” 実行時に僕の環境では、”System.NotSupportedException: SQLite does not support this migration operation (‘AlterColumnOperation’).” が発生。https://github.com/aspnet/AspNetCore.Docs/issues/11268 にあるように、”dotnet ef migrations remove” 実行後に、再度 ”dotnet ef database update” を実行すると成功しました。

デバッグ

IIS Expresss でデバッグを実行します。トップページの Register リンクをクリックして、アカウントを登録します。

上記の図のようにログイン状態になると、アカウント登録は成功です。一応データベースの登録内容を確認します。

:: プロジェクトファイルのフォルダに移動
cd *****
:: データベースに接続
sqlite3 app.db
SQLite version 3.30.1 2019-10-10 20:19:45
Enter ".help" for usage hints.
:: テーブル一覧を確認
sqlite>.table
AspNetRoleClaims       AspNetUserLogins       AspNetUsers
AspNetRoles            AspNetUserRoles        __EFMigrationsHistory
AspNetUserClaims       AspNetUserTokens
:: 登録したアカウントを確認
sqlite> select * from AspNetUsers where Email = 'hogehoge@test.com';
ab548b2b-20d2-4919-8bfc-4333142de1af|hogehoge@test.com|HOGEHOGE@TEST.COM|hogehoge@test.com|HOGEHOGE@TEST.COM|0|AQAAAAEAACcQAAAAEOdAd+ybsxorv8CXwrDFUtlwIFihFcxtoWpWBG7rbmHFCbalS+EQZjKCW1fLi8bRSQ==|KYKMPFJ5M47IIAB6NM77MNO6SC66CIO7|ae690c9f-b207-4a51-b8f2-67e3479a88c2||0|0||1|0

:: プロジェクトファイルのフォルダに移動

cd *****

:: データベースに接続

sqlite3 app.db

SQLite version 3.30.1 2019-10-10 20:19:45

Enter ".help" for usage hints.

:: テーブル一覧を確認

sqlite>.table

AspNetRoleClaims AspNetUserLogins AspNetUsers

AspNetRoles AspNetUserRoles __EFMigrationsHistory

AspNetUserClaims AspNetUserTokens

:: 登録したアカウントを確認

sqlite> select * from AspNetUsers where Email = 'hogehoge@test.com';

ab548b2b-20d2-4919-8bfc-4333142de1af|hogehoge@test.com|HOGEHOGE@TEST.COM|hogehoge@test.com|HOGEHOGE@TEST.COM|0|AQAAAAEAACcQAAAAEOdAd+ybsxorv8CXwrDFUtlwIFihFcxtoWpWBG7rbmHFCbalS+EQZjKCW1fLi8bRSQ==|KYKMPFJ5M47IIAB6NM77MNO6SC66CIO7|ae690c9f-b207-4a51-b8f2-67e3479a88c2||0|0||1|0

今回作成した ASP.NET Core MVC アプリを WSL Ubuntu + Nginx でホストするのは、こちらをご覧ください。

雲の上はいつも晴れ