.NET Core

| C Sharp | ASP.NET Core | .NET Core Console | Xamarin |

.NET Core

link

• .NET Standard - .NET Core と .NET Standard の分かりやすい解説
• .NET のドキュメント

.NET Core

---

• 最新の .NET 実装です。オープン ソースで、複数の OS 向けに利用できます。
• .NET Core により、クロスプラットフォーム コンソール アプリケーション、ASP.NET Core Web アプリケーション、およびクラウド サービスをビルドできます。

.NET Standard

---

• すべての .NET 実装が実装する必要のある基本 API のセットです。
• この API を基本クラス ライブラリ (BCL) と呼びます。
• .NET Standard をターゲットにすることで、どの .NET 実装やどの OS で実行されても、すべての .NET アプリケーションが共有できるライブラリをビルドできます。

.NET API ブラウザ

---

• https://docs.microsoft.com/ja-jp/dotnet/api/

.NET ソースブラウザ

---

• https://source.dot.net/

インストール

ダウンロード

---

• https://dotnet.microsoft.com/download#/lts

Mac

---

• https://dotnet.microsoft.com/download/dotnet/3.1
• https://docs.microsoft.com/ja-jp/dotnet/core/install/macos
• ASP.NET Core参照

アンインストールツール

---

• https://docs.microsoft.com/ja-jp/dotnet/core/additional-tools/uninstall-tool?tabs=windows

CLIコマンド

• https://docs.microsoft.com/ja-jp/dotnet/core/tools/

SDKコマンド

---

コマンド	内容
dotnet --info	.NET Core 情報の表示

パッケージの追加

---

• https://www.nuget.org/

dotnet add package Microsoft.Extensions.Configuration.Binder --version 5.0.0
dotnet add package Microsoft.Extensions.Configuration.CommandLine --version 5.0.0
dotnet add package Microsoft.Extensions.Configuration.Json --version 5.0.0
dotnet add package Microsoft.Extensions.DependencyInjection --version 5.0.1
dotnet add package Microsoft.Extensions.Hosting --version 5.0.0
dotnet add package Microsoft.Extensions.Options --version 5.0.0
dotnet add package MongoDB.Driver --version 2.12.4
dotnet add package Newtonsoft.Json.Bson --version 1.0.2
dotnet add package Newtonsoft.Json --version 13.0.1
dotnet add package Microsoft.Extensions.Logging.Log4Net.AspNetCore --version 5.0.3

Windows Proxy設定について

• 一時的に環境変数にプロキシを設定して対応
• set HTTP_PROXY=http:(ユーザーID):(パスワード)@(プロキシ):(ポート番号)
• set HTTPS_PROXY=http:(ユーザーID):(パスワード)@(プロキシ):(ポート番号)

• dotnet coreにおけるhttp proxy設定に関する注意点
• Windows のプロキシ

> netsh winhttp show proxy > netsh winhttp import proxy source=ie

.gitignoreの作成

---

$ dotnet new gitignore

プロジェクトレンプレート

dotnet new

---

• https://docs.microsoft.com/ja-jp/dotnet/core/tools/dotnet-new?tabs=netcore21

$ dotnet new web

ソリューション

---

• カレントディレクトリにソリューションファイルを作成

$ dotnet new sln -o .

• カレントディレクトリのソリューションにプロジェクトを追加

$ dotnet sln add {プロジェクトファイルパス}

• ビルド

$ dotnet clean
$ dotnet build

NET での依存関係の挿入

• https://docs.microsoft.com/ja-jp/dotnet/core/extensions/dependency-injection

サービスの有効期間

---

意味	名称	内容
一時的	AddTransient	有効期間が一時的なサービスは、サービス コンテナーから要求されるたびに作成されます。 この有効期間は、軽量でステートレスのサービスに最適です
スコープ	AddScoped	Web アプリケーションの場合、スコープ付き有効期間は、クライアント要求 (接続) ごとにサービスが 1 回作成されることを示します
シングルトン	AddSingleton	シングルトン有効期間サービスが作成されるのは、次のいずれかの場合です。 それらが初めて要求された場合。 開発者によって、実装インスタンスがコンテナーに直接提供される場合。 このアプローチはほとんど必要ありません。

サービス登録メソッド

---

メソッド	例	自動object破棄	複数実装	引数を渡す
Add{LIFETIME}<{SERVICE}, {IMPLEMENTATION}>()	services.AddSingleton<IMyDep, MyDep>();	Y	Y	N
Add{LIFETIME}<{SERVICE}>(sp => new {IMPLEMENTATION})	services.AddSingleton<IMyDep>(sp => new MyDep()); services.AddSingleton<IMyDep>(sp => new MyDep(99));	Y	Y	Y
Add{LIFETIME}<{IMPLEMENTATION}>()	services.AddSingleton<MyDep>();	Y	N	N
AddSingleton<{SERVICE}>(new {IMPLEMENTATION})	services.AddSingleton<IMyDep>(new MyDep()); services.AddSingleton<IMyDep>(new MyDep(99));	N	Y	Y
AddSingleton(new {IMPLEMENTATION})	services.AddSingleton(new MyDep()); services.AddSingleton(new MyDep(99));	N	N	Y

Cannot consume scoped service from singleton

• 既定では、開発環境で、より長い有効期間を持つ別のサービスからサービスを解決すると、例外がスローされます。
• スコープの検証
• シングルトンからスコープ付きサービスを解決 しない でください。また、たとえば一時的なサービスにより、間接的に解決しないようにご注意ください

コンソールアプリケーションでDIからサービスを取得

• https://andrewlock.net/using-dependency-injection-in-a-net-core-console-application/
• 初期化

 return Host.CreateDefaultBuilder (args)
        .ConfigureServices ((hostContext, services) => {
            services.AddSingleton<ServiceProvider>(services.BuildServiceProvider());
       });

• ServiceProvider をコンストラクタインジェクション
• 利用時

_serviceProvider.GetService<IHoge>()

exe を出力

• https://kagasu.hatenablog.com/entry/2017/04/16/192117

デプロイ方法の名称	略称	実行方法
Framework-dependent deployments	FDD	コマンドで dotnet hoge.dll として実行する
Self-contained deployments	SCD	実行ファイルを直接実行する

日本語コーデック

• NuGet で System.Text.Encoding.CodePages を追加
• 初期化時に 以下を実行
  • System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance);

Console

設定ファイル

dotnet add package Microsoft.Extensions.Configuration.Json --version 5.0.0

using System;
using System.IO;
using Microsoft.Extensions.Configuration;

namespace docweb_bat
{
    public class Program
    {
        static void Main(string[] args)
        {
            // export DECWEB_ENV=Development
            var environmentName = Environment.GetEnvironmentVariable("DOCWEB_ENV");
            Console.WriteLine($"Environment:{environmentName}");
       
            IConfiguration configuration = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json", true, true)
                .AddJsonFile($"appsettings.{environmentName}.json", true, true)
                .Build();
            
            IConfigurationSection section = configuration.GetSection("DocumentWebDatabaseSettings");
            string str = section["DocumentWebCollectionName"];
            Console.WriteLine(str);
        }
    }
}