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

MyMemoWiki

.NET Core

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

| C Sharp | ASP.NET Core | .NET Core Console | 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

  • 構成
    • /etc/nginx/sites-available/default に追記
  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. }

アンインストールツール


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からサービスを取得

 return Host.CreateDefaultBuilder (args)
        .ConfigureServices ((hostContext, services) => {
            services.AddSingleton<ServiceProvider>(services.BuildServiceProvider());
       });
  • ServiceProvider をコンストラクタインジェクション
  • 利用時
_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

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

dotnet add package System.CommandLine --version 2.0.0-beta3.22111.2
using System;
using System.CommandLine;
using System.CommandLine.Invocation;
using System.IO;
using System.Reflection;

public class Program
{
    static int Main(string[] args)
    {
        var converterOption = new Argument<string>("converter", "Converter Name");
        var infoOption = new Option<bool>(new string[] { "-i", "--info" }, "information");
        var rootCommand = new RootCommand { converterOption, infoOption };
        rootCommand.Description = "Convert";

        rootCommand.SetHandler((string converter, bool info) =>
        {
            Console.WriteLine($"{converter} {info}");
        }, converterOption, infoOption);

        return rootCommand.Invoke(args);
    }
}
Description:
  Convert

  hogehoge <converter> [options]

Arguments:
  <converter>  Converter Name

Options:
  -i, --info      information
  --version       Show version information
  -?, -h, --help  Show help and usage information

> dotnet run "conv"
conv False

設定ファイル

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);
        }
    }
}