| ページ一覧 | ブログ | twitter |  書式 | 書式(表) |

MyMemoWiki

.NET Core

提供: MyMemoWiki
2022年4月15日 (金) 12:36時点におけるPiroto (トーク | 投稿記録)による版 (→‎Nginx)
ナビゲーションに移動 検索に移動

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

.NET Core

.NET Core


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

.NET Standard


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

.NET API ブラウザ


.NET ソースブラウザ


インストール

ダウンロード


Mac


Linux

Ubuntu

  • Ubuntuにインストール
  • .NET アプリを開発する場合は、SDK をインストール (ランタイムが含まれます)
  • アプリを実行する必要があるだけの場合は、ランタイムをインストール
  • ランタイムをインストールする場合は、ASP.NET Core ランタイムをインストールすることを推奨(.NET と ASP.NET の Core ランタイムの両方が含まれているため)
20.0.4
  • 信頼されたキーの一覧に Microsoft パッケージ署名キーを追加し、パッケージ リポジトリを追加
  1. $ wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  2. $ sudo dpkg -i packages-microsoft-prod.deb
  3. $ rm packages-microsoft-prod.deb
  • .NET 6.0 SDK インストール
  1. $ sudo apt-get update
  2. $ sudo apt-get install -y apt-transport-https
  3. $ sudo apt-get install -y dotnet-sdk-6.0
  • .NET 6.0 Runtime インストール
  1. $ sudo apt-get update
  2. $ sudo apt-get install -y apt-transport-https
  3. $ sudo apt-get install -y aspnetcore-runtime-6.0
Nginx
  1. $ sudo apt update
  2. $ sudo apt install nginx
  3. $ sudo service nginx start

Nginx start.png

  1. server {
  2. listen 80;
  3. listen [::]:80;
  4. server_name dotnet-study.local *.dotnet-study.local;
  5. location / {
  6. proxy_pass http://127.0.0.1:5000;
  7. proxy_http_version 1.1;
  8. proxy_set_header Upgrade $http_upgrade;
  9. proxy_set_header Connection keep-alive;
  10. proxy_set_header Host $host;
  11. proxy_cache_bypass $http_upgrade;
  12. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  13. proxy_set_header X-Forwarded-Proto $scheme;
  14. }
  15. }
  • Blazor Serverサービスを構成
  1. $ sudo vi /etc/systemd/system/blazorsvr-app.service

アンインストールツール


CLIコマンド

SDKコマンド


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

パッケージの追加


  1. dotnet add package Microsoft.Extensions.Configuration.Binder --version 5.0.0
  2. dotnet add package Microsoft.Extensions.Configuration.CommandLine --version 5.0.0
  3. dotnet add package Microsoft.Extensions.Configuration.Json --version 5.0.0
  4. dotnet add package Microsoft.Extensions.DependencyInjection --version 5.0.1
  5. dotnet add package Microsoft.Extensions.Hosting --version 5.0.0
  6. dotnet add package Microsoft.Extensions.Options --version 5.0.0
  7. dotnet add package MongoDB.Driver --version 2.12.4
  8. dotnet add package Newtonsoft.Json.Bson --version 1.0.2
  9. dotnet add package Newtonsoft.Json --version 13.0.1
  10. dotnet add package Microsoft.Extensions.Logging.Log4Net.AspNetCore --version 5.0.3
Windows Proxy設定について
  • 一時的に環境変数にプロキシを設定して対応
  • set HTTP_PROXY=http:(ユーザーID):(パスワード)@(プロキシ):(ポート番号)
  • set HTTPS_PROXY=http:(ユーザーID):(パスワード)@(プロキシ):(ポート番号)


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

.gitignoreの作成


  1. $ dotnet new gitignore

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

dotnet new


  1. $ dotnet new web
  • 一覧表示
  1. $ dotnet new --list
  2. これらのテンプレートは、入力: と一致しました
  3.  
  4. テンプレート名 短い名前 言語 タグ
  5. --------------------------------- -------------- ---------- --------------------------
  6. ASP.NET Core Empty web [C#],F# Web/Empty
  7. ASP.NET Core gRPC Service grpc [C#] Web/gRPC
  8. ASP.NET Core Web API webapi [C#],F# Web/WebAPI
  9. ASP.NET Core Web App webapp,razor [C#] Web/MVC/Razor Pages
  10. ASP.NET Core Web App (Model-Vi... mvc [C#],F# Web/MVC
  11. ASP.NET Core with Angular angular [C#] Web/MVC/SPA
  12. ASP.NET Core with React.js react [C#] Web/MVC/SPA
  13. Blazor Server App blazorserver [C#] Web/Blazor
  14. Blazor WebAssembly App blazorwasm [C#] Web/Blazor/WebAssembly/PWA
  15. dotnet gitignore ファイル gitignore Config
  16. dotnet ローカル ツール マニフ... tool-manifest Config
  17. EditorConfig ファイル editorconfig Config
  18. global.json ファイル globaljson Config
  19. MSTest Test Project mstest [C#],F#,VB Test/MSTest
  20. MVC ViewImports viewimports [C#] Web/ASP.NET
  21. MVC ViewStart viewstart [C#] Web/ASP.NET
  22. NuGet Config nugetconfig Config
  23. NUnit 3 Test Item nunit-test [C#],F#,VB Test/NUnit
  24. NUnit 3 Test Project nunit [C#],F#,VB Test/NUnit
  25. Protocol Buffer File proto Web/gRPC
  26. Razor Class Library razorclasslib [C#] Web/Razor/Library
  27. Razor Component razorcomponent [C#] Web/ASP.NET
  28. Razor Page page [C#] Web/ASP.NET
  29. Web 構成 webconfig Config
  30. Worker Service worker [C#],F# Common/Worker/Web
  31. xUnit Test Project xunit [C#],F#,VB Test/xUnit
  32. クラス ライブラリ classlib [C#],F#,VB Common/Library
  33. コンソール アプリ console [C#],F#,VB Common/Console
  34. ソリューション ファイル sln Solution

ソリューション


  • カレントディレクトリにソリューションファイルを作成
  1. $ dotnet new sln -o .
  • カレントディレクトリのソリューションにプロジェクトを追加
  1. $ dotnet sln add {プロジェクトファイルパス}
  • ビルド
  1. $ dotnet clean
  2. $ dotnet build

NET での依存関係の挿入


サービスの有効期間


意味 名称 内容
一時的 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からサービスを取得

  1. return Host.CreateDefaultBuilder (args)
  2. .ConfigureServices ((hostContext, services) => {
  3. services.AddSingleton<ServiceProvider>(services.BuildServiceProvider());
  4. });
  • ServiceProvider をコンストラクタインジェクション
  • 利用時
  1. _serviceProvider.GetService<IHoge>()

exe を出力

デプロイ方法の名称 略称 実行方法
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

コマンドライン オプションの解析

  1. dotnet add package System.CommandLine --version 2.0.0-beta3.22111.2
  1. using System;
  2. using System.CommandLine;
  3. using System.CommandLine.Invocation;
  4. using System.IO;
  5. using System.Reflection;
  6.  
  7. public class Program
  8. {
  9. static int Main(string[] args)
  10. {
  11. var converterOption = new Argument<string>("converter", "Converter Name");
  12. var infoOption = new Option<bool>(new string[] { "-i", "--info" }, "information");
  13. var rootCommand = new RootCommand { converterOption, infoOption };
  14. rootCommand.Description = "Convert";
  15.  
  16. rootCommand.SetHandler((string converter, bool info) =>
  17. {
  18. Console.WriteLine($"{converter} {info}");
  19. }, converterOption, infoOption);
  20.  
  21. return rootCommand.Invoke(args);
  22. }
  23. }
  1.  
  2. Description:
  3. Convert
  4.  
  5. hogehoge <converter> [options]
  6.  
  7. Arguments:
  8. <converter> Converter Name
  9.  
  10. Options:
  11. -i, --info information
  12. --version Show version information
  13. -?, -h, --help Show help and usage information
  14.  
  15. > dotnet run "conv"
  16. conv False

設定ファイル

  1. dotnet add package Microsoft.Extensions.Configuration.Json --version 5.0.0
  1. using System;
  2. using System.IO;
  3. using Microsoft.Extensions.Configuration;
  4.  
  5. namespace docweb_bat
  6. {
  7. public class Program
  8. {
  9. static void Main(string[] args)
  10. {
  11. // export DECWEB_ENV=Development
  12. var environmentName = Environment.GetEnvironmentVariable("DOCWEB_ENV");
  13. Console.WriteLine($"Environment:{environmentName}");
  14. IConfiguration configuration = new ConfigurationBuilder()
  15. .SetBasePath(Directory.GetCurrentDirectory())
  16. .AddJsonFile("appsettings.json", true, true)
  17. .AddJsonFile($"appsettings.{environmentName}.json", true, true)
  18. .Build();
  19. IConfigurationSection section = configuration.GetSection("DocumentWebDatabaseSettings");
  20. string str = section["DocumentWebCollectionName"];
  21. Console.WriteLine(str);
  22. }
  23. }
  24. }