ASP.NET Core

あまりにも情報不足なのと、Microsoftからの情報提供が悪過ぎるのにムカついたので書きまくる！

---

本サイト内関連ページ

• ASP.NET Core/IIS
• ASP.NET Core/データベース

• ASP.NET Core MVC
• ASP.NET Core MVC/Model
• ASP.NET Core MVC/View
• ASP.NET Core MVC/Controller
• ASP.NET Core MVC/ルーティング
• ASP.NET Core MVC/状態管理

---

• ASP.NET Core - Binary Intellect Knowledge Base
• ASP.NET Core ClockUpTips
• ASP.NET Core チュートリアル
• ASP.NET MVCの用語

• 「いよいよ登場「ASP.NET Core 1.0」 マルチプラットフォームな.NETとは？」連載一覧
• Hello World, ASP.NET Core 1.0!
• ASP.NET Core 1.0の概要を整理する
• ASP.NET Core - マイクロソフト系技術情報 Wiki - OSSコンソーシアム
• .NET Core 1.1 をリリース

• ASP.NETからASP.NET Coreに移行した話
• ASP.NET MVC アプリケーションを ASP.NET Core MVC にマイグレーションしようとして挫折した話

• ASP.NET Core MVC に関する投稿

• macOS ではじめる ASP.NET Core x Entity Framework Core x PostgreSQL
• .NET Core on Linux Handson
• ASP.NET Core アプリを Linux サーバーで公開

• ASP.NET Core を始める際に知っておきたい Web フロントエンドツールの種類と最新トレンド

• ASP.NET Coreの雛形コードを見てみよう
• 「ASP.NET Core 2.0」の変更点とインストール方法を知ろう

• ASP.NET Core Web APIのための高度なアーキテクチャ

• ASP.NET Coreを始める前に知っておきたい19のこと

• Reactの人気を超えたASP.NET Coreとは？

概要 †

ASP.NETの歴史 †

• 1996年 : Active Server Pages
• 2002年 : ASP.NET
• 2009年 : ASP.NET MVC
• 2016年 : ASP.NET Core

ASP.NET Core の特徴 †

• オープンソースで開発されている
• 動作環境がWindowsに加えMacとLinuxに正式に対応した
• これまで個別の機能であった「ASP.NET MVC」「WebAPI」「WebPages?」は、ASP.NET Coreで再設計され、1つに統合された
• Linux／Mac／Windows共通で使用できるコマンドラインインターフェース「.NET CLI」が用意された。このコマンドを使用することで、リポジトリから取得してきたソースコードを、環境を意識することなく依存解決を行い、ビルドし、実行できるようになった。
• IIS 非依存。libuvベースのKestrelという新しいWebサーバーが提供され、IISやNginxとの連携することもできる。

• MVC/Entity Framework Core の知識を必須とするため、ASP.NET Web Forms や型付きデータセットで開発されてきた方々には、非常にハードルが高い開発プラットフォームにもなっている
• 高水準 UI 部品が大量に存在していた ASP.NET Web Forms から、いきなりスクラッチ開発に近い ASP.NET MVC/EF 開発ベースに移れと言われても正直キツイ（らしい）

ハンズオン †

• ASP.NET Core MVC の概要

• Visual Studio Codeを使用してASP.NET CoreでHello World WEBアプリ作成
• .NET Core と VS Code によるクロスプラットフォーム Web 開発環境

パフォーマンス †

• ASP.NET Core のパフォーマンスに関するベスト プラクティス
• C# 7.2 with .NET Core 2.1

• Azure App Service 上での ASP.NET Core 2.2 のパフォーマンス

• .NET Coreで作成した Web APIアプリを Windows サービスで動かす

• ASP.NET と ASP.NET Core のパフォーマンスを比較する（2018年10月版）
• ASP.NET と ASP.NET Coreのパフォーマンスを比較する

• C#コードの最適化：より良いアセンブリコードを生成させる裏技:https://medium.com/@joni2nja/c-コードの最適化-より良いアセンブリコードを生成させる裏技-74c5163abbe0

アプリケーションの構成 †

• Application Startup in ASP.NET Core - 日本語意訳
• ASP.NET Core 1.0 の Startup クラス定義の基本と Dependency Injection の話

Startupクラス †

• ASP.NET Core アプリケーションには Startup クラスが必要
• Startup クラスのコンストラクタに、dependency injection によってオブジェクトを注入することができる。例えば、
  • IHostingEnvironment? を注入して構成ソースを設定
  • ILoggerFactory? を注入してlogging プロバイダーを設定
• Startup クラスには Configure メソッドが必須で、オプションで ConfigureServices? メソッドを含めることができる

Configureメソッド（必須） †

• ASP.NET Core アプリケーションが HTTP リクエストにどのように応答するかを指定するために使用される

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    loggerFactory.AddConsole(Configuration.GetSection("Logging"));
    loggerFactory.AddDebug();

    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        app.UseDatabaseErrorPage();
        app.UseBrowserLink();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
    }

    app.UseStaticFiles();

    app.UseIdentity();

    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

ConfigureServices?メソッド（オプション） †

• Configure メソッドの前に呼び出される
• 構成オプション はこのメソッドで設定される
• 実質的なセットアップが必要な機能のために、IServiceCollection? には Add[Service] 拡張メソッドが用意される

public void ConfigureServices(IServiceCollection services)
{
    // Add framework services.
    services.AddDbContext<ApplicationDbContext>(options =>
        options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

    services.AddIdentity<ApplicationUser, IdentityRole>()
        .AddEntityFrameworkStores<ApplicationDbContext>()
        .AddDefaultTokenProviders();

    services.AddMvc();
}

Dependency Injection †

• AddMvc? や AddDbContext? などフレームワークが提供している拡張メソッドも、実際は内部で必要なクラスをコンテナに追加しているに過ぎない
• デフォルトの DI コンテナでは 3 種類存在している

• AddSingleton?
  • アプリケーション中で 1 つだけインスタンス化
• AddScoped?
  • リクエスト中で 1 つだけインスタンス化
• AddTransient?
  • 常に新しくインスタンス化

• 使いなれた DI コンテナに切り替えたい場合は、ConfigureServices? メソッドで IServiceProvider? を返すだけで良い？
  • 基本的にはコンストラクタへのインジェクションのみ
  • IServiceProvider? をコンストラクタで受けとれば、任意のインスタンスを作成できそう

日本語処理 †

文字エンコーダーの設定変更 †

View に

汉语/漢語

のような文字が表示される場合はこの設定変更を検討する。

• ASP.Net Core + Razorで日本語がエスケープされないようにする
  • Startup.cs に以下の記述を加える

    using System.Text.Encodings.Web;
    using System.Text.Unicode;
    
    public void ConfigureServices(IServiceCollection services) {
        services.AddSingleton(HtmlEncoder.Create(UnicodeRanges.BasicLatin,
                                                 UnicodeRanges.CjkSymbolsandPunctuation,
                                                 UnicodeRanges.Hiragana, 
                                                 UnicodeRanges.Katakana,
                                                 UnicodeRanges.CjkUnifiedIdeographs));
        // その他 .AddMvc() など...
    }

  • デフォルトではHtmlEncoder?.Defaultが使われ、これがU+0000..U+007F以外は全てエスケープする設定になっている
  • なので、そこでDIにて日本語も許容するように設定

• クロスサイト スクリプティングの防止

バージョン †

2.1 †

• 2018 年 5 月 30 日に、.NET Core 2.1 と ASP.NET Core 2.1 がリリースされた
• .NET Core 2.1は長期サポートリリース（LTS）になるため、古いプラットフォームの開発者はできるだけ早くアップグレードした方がよい
• 2018年10月1日を以って「.NET Core 2.0」のサポートが終了した

• ASP.NET Core 2.1 の新機能
• .NET Core 2.1.0がリリースされました
• .NET Core 2.1の不具合のため.NET Core 2.0が延命

• Migrate from ASP.NET Core 2.0 to 2.1
  • ASP.NET Core 2.0 から 2.1 への移行
• ASP.NET Core 2.1 コード ベースへの移行
• ASP.NET Core 2.0 から 2.1 へのアップデートを行ったメモ
• ASP.NET Core 2.1 への移行
• ASP.NET Core：daruyanagi.jp を ASP.NET Core 2.1 へ移行させた

• ASP.NET Core 2.1をhttps://localhostで動かす

• ASP.NET Core 2.1 を IIS でホストする時にハマったメモ

• How to Migrate .NET Core Projects From 2.0 to 2.1

2.2 †

• Announcing ASP.NET Core 2.2, available today!

• Azure App Service 上での ASP.NET Core 2.2 のパフォーマンス
• Azure App Service で ASP.NET Core 2.2 と ANCM v2 が使えるようになった

• ASP.NET Core 2.2 で追加された Health Checks API の基本的な使い方とカスタマイズ

• ASP.NET Core 2.1 => 2.2 へマイグレーションした。

3.0 †

• 既存の WPF アプリケーションを .NET Core 3.0 に移行した