.NET Standardへの移行 のバックアップ(No.26)

[ トップ ]   [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• .NET Standardへの移行 へ行く。
  • 1 (2018-03-28 (水) 15:45:31)
  • 2 (2018-03-28 (水) 18:31:11)
  • 3 (2018-03-29 (木) 11:57:15)
  • 4 (2018-03-29 (木) 14:37:24)
  • 5 (2018-03-29 (木) 16:59:22)
  • 6 (2018-03-30 (金) 10:34:44)
  • 7 (2018-03-30 (金) 15:54:30)
  • 8 (2018-03-30 (金) 21:29:52)
  • 9 (2018-04-02 (月) 11:59:06)
  • 10 (2018-04-02 (月) 21:29:55)
  • 11 (2018-04-03 (火) 12:31:43)
  • 12 (2018-04-04 (水) 12:00:34)
  • 13 (2018-04-05 (木) 11:37:57)
  • 14 (2018-04-05 (木) 20:20:53)
  • 15 (2018-04-06 (金) 10:20:10)
  • 16 (2018-04-09 (月) 11:58:52)
  • 17 (2018-04-10 (火) 09:39:59)
  • 18 (2018-04-17 (火) 13:04:22)
  • 19 (2018-04-19 (木) 18:33:48)
  • 20 (2018-04-19 (木) 18:52:26)
  • 21 (2018-04-20 (金) 10:38:58)
  • 22 (2018-04-23 (月) 14:14:31)
  • 23 (2018-04-24 (火) 09:12:22)
  • 24 (2018-04-24 (火) 17:53:35)
  • 25 (2019-02-19 (火) 11:34:58)
  • 26 (2019-08-07 (水) 18:47:52)
  • 27 (2019-08-22 (木) 12:49:18)
  • 28 (2019-08-23 (金) 11:02:02)
  • 29 (2019-08-26 (月) 17:26:16)

---

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

• 戻る
  • .NET Standard
  • 移行・マイグレーション
    • .NETのクロスプラットフォーム対応

目次 †

概要 †

※ 対象は、.NET Standard 2.0。

• 下記の「移行元 / 移行先」の、「.NET Standard」移行ノウハウをサマリする。
  
• コチラに書いた通り、PCLと比べて移行はし易い感じ。

詳細 †

準備 †

移行プロセスの確認 †

移行性評価の実施 †

必要に応じて、以下ツールを使用し移行性を評価する。

• .NET Portability Analyzer
  • .NET Portability Analyzer - .NET | Microsoft Docs
    https://docs.microsoft.com/ja-jp/dotnet/standard/analyzers/portability-analyzer
  • Portability Analyzerを使ってライブラリの.NET Standard準拠を調べよう - ryuichi111stdの技術日記
    http://ryuichi111std.hatenablog.com/entry/2017/03/07/142248

• .NET Compatibility Diagnostic Tools
  • NuGet Gallery | Microsoft.DotNet?.FrameworkCompatibilityDiagnostics? 0.5.0
    https://www.nuget.org/packages/Microsoft.DotNet.FrameworkCompatibilityDiagnostics/
  • .NET Framework の互換性の診断 – Visual Studio 日本チーム Blog
    https://blogs.msdn.microsoft.com/visualstudio_jpn/2016/03/02/net-framework/
  • .NET API アナライザー | Microsoft Docs
    https://docs.microsoft.com/ja-jp/dotnet/standard/analyzers/api-analyzer
  • .NET Coreへの移植 | ++C++; // 未確認飛行 C ブログ
    http://ufcpp.net/blog/2016/2/porting-to-net-core/

移行先プロジェクトを準備する。 †

不要なファイルを削除する。

• packages.config
• Properties\AssemblyInfo?.cs

Projectファイルを準備する。 †

• 以下のようなProjectファイルを準備する。
  （既存のProjectファイルの中身を以下で置き換えればイイ）

  <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
      <TargetFramework>netstandard2.0</TargetFramework>
    </PropertyGroup>
  </Project>

• .NET Standardでは、配下のSourceファイルが自動で追加される。
  必要に応じて、ファイルやフォルダの除外設定を行う。
  ※ netstandardやnetcoreでは、除外されるファイルやフォルダだけがProjectファイルに明記される。

ProjectをVisual Studioから開く。 †

Projectファイルをダブルクリックするか、空のソリューションに追加する。

Projectの初期設定を行う。 †

<PropertyGroup>
  <TargetFramework>netstandard2.0</TargetFramework>
  <AssemblyName>XXXX</AssemblyName>
  <RootNamespace>YYYY</RootNamespace>
</PropertyGroup>

ポーティング移行 †

移行対象ファイルを選別する。 †

• コンパイル・エラーをチェックしながら移行対象ファイルを選別する。
• クラス・メソッドの有/無については、以下の検索システムを使用すると良い。

必要に応じて、NuGetパッケージを追加する。 †

• 「参照無し」が発生したら、NuGetパッケージを確認しインストール。
  NuGetパッケージにnetstandardが含まれるかどうかを確認する。
  （パッケージを解凍して、中を直接確認してもイイ）

• 以下のライブラリの移行先をNuGetパッケージから探す。
  • System系ライブラリ
    • System.Configuration.ConfigurationManager

• System.Data系ライブラリ
  ADO.NETデータプロバイダ
  • System.Data.SqlClient?
  • System.Data.Odbc
  • Npgsql
  • MySql?.Data

• ASP.NET Core系ライブラリ
  ※ ココが比較的、大変。

• その他ライブラリ
  • log4net
  • Json.NET

• 参考
  • .NET Core に移植する - Windows 互換機能パックの使用
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/windows-compat-pack

必要に応じて、ポーティング移行する。 †

以下のPlatformやLibraryに依存していた処理を、削除するか、ポーティング移行する。

• Windows
• net11 - net47 - netXX
• Microsoft.VisualBasic?
• 上記以外のNuGetパッケージ

パッケージ・マネージャ †

NuGet †

引き続き使用できる。 †

• .NET Standard、.NET Coreでも、引き続きNuGetを使用できる。
• １つのNuGetパッケージには、.NET Framework以外に、
  .NET Standard、.NET Coreのライブラリを同梱してパッケージ化できる。

Dependencies †

.NET Standard、.NET Core開発に活用できるNuGetライブラリは、
.NET Standard、.NET Core 側にだけ、Dependencies を持つ。

※ しかし、実際には、Dependenciesが正確に書かれていないケースも多く、
　（「target="lib\netXXX」毎にDependenciesが異なるので当然と言えば当然）
　実際にインストールして.NET Standardに対応しているかどうかを判断する。

System系ライブラリ †

*.config †

ADO.NET †

型付きDataSet? †

• （今の所、）型付きDataSet?がない。
• 参考
  • Port xsd.exe to .NET Core · Issue #8647 · dotnet/corefx
    https://github.com/dotnet/corefx/issues/8647

DatasetExtensions? †

LINQ to DataSet?を使用できない。

• 参考
  • Port DatasetExtensions? to .NET Core · Issue #19771 · dotnet/corefx
    https://github.com/dotnet/corefx/issues/19771

その他ライブラリ †

log4net †

• 一部、インターフェイスの変更があるもよう。
• 引数にRepositoryが必要になったようだが、
  Microsoft.Extensions.Logging.ILoggerProvider?の規則などには関係が無い模様。

参考 †

• How to use Log4Net with ASP.NET Core for logging | dotnetthoughts
  https://dotnetthoughts.net/how-to-use-log4net-with-aspnetcore-for-logging/
• Essential .NET - .NET Core によるログ記録
  https://msdn.microsoft.com/ja-jp/magazine/mt694089.aspx

その他 †

• DotNetZip? ---> ・・・
• System.Net.Mail ---> MailKit?
• System.Drawing ---> ImageProcessor?

ASP.NET Core系ライブラリ †

• 対応するライブラリが「Microsoft.AspNetCore?.XXXX」にある可能性がある。
• これらのライブラリはASP.NET Coreではなく、.NET Standard前提になる。
  https://www.nuget.org/packages/Microsoft.AspNetCore.All

System.Web †

対応するライブラリが「Microsoft.AspNetCore?.XXXX」にある可能性がある。

RootPath? †

• 参考
  • Webサイトのパスを取得する方法
  • asp.net core - Access IApplicationEnvironment?.ApplicationBasePath? - Stack Overflow
    https://stackoverflow.com/questions/37298402/access-iapplicationenvironment-applicationbasepath
  • Getting the Web Root Path and the Content Root Path in ASP.NET Core | Marius Schulz
    https://blog.mariusschulz.com/2016/05/22/getting-the-web-root-path-and-the-content-root-path-in-asp-net-core

HttpContext? †

• c# - How to get HttpContext?.Current in ASP.NET Core? - Stack Overflow
  https://stackoverflow.com/questions/38571032/how-to-get-httpcontext-current-in-asp-net-core
• Accessing HttpContext? outside of framework components in ASP.NET Core | StrathWeb?. A free flowing web tech monologue.
  https://www.strathweb.com/2016/12/accessing-httpcontext-outside-of-framework-components-in-asp-net-core/

※ 上記の「Mimicking HttpContext?.Current」で.NET Standardなライブラリ化も可能。

Session †

※ HttpContext経由でアクセスする。

Cookie †

• ASP.NET Core Working With Cookie
  https://www.c-sharpcorner.com/article/asp-net-core-working-with-cookie/
• ASP.NET Core 2.0 MVC で Cookie を利用する - Qiita
  https://qiita.com/code0327/items/26c09c83103083ae57b7

その他 †

• System.Web.Routing.RouteTable? ---> Microsoft.AspNetCore?.Routing.RouteTable?
• ・・・

Microsoft.Owin †

対応するライブラリが「Microsoft.AspNetCore?.XXXX」にある可能性がある。

Base64Url †

• Microsoft.AspNetCore.WebUtilities

ASP.NET Core系ミドルウェア †

Filters †

Microsoft.AspNetCore?.Mvc.Filters

Filterクラス †

• Filterパイプラインが再実装されて、分かりやすくシンプルになった。
• ASP.NET MVC 5 と同じように扱える抽象クラスが Core MVC でも用意されている。
  （ActionFilterAttribute?, ResultFilterAttribute?, ExceptionFilterAttribute?）
• Resource Filterにより、キャッシュなどパフォーマンスの改善の実装が容易に。
• ただし、一部にインターフェイスの変更はある（フィルタ・メソッド、属性の引数）
• また、下記が追加された。
  • 非同期版のメソッドの追加。
  • 属性だけでなくDIとの連携した適用が可能になった。

参考 †

• Filters
  • フィルター | Microsoft Docs
    https://docs.microsoft.com/ja-jp/aspnet/core/mvc/controllers/filters
  • ASP.NET Core MVC で大きく変わったフィルタについて調べた - しばやん雑記
    http://blog.shibayan.jp/entry/20160727/1469596437
  • アクションフィルタ - コントローラ詳細 - ASP.NET Core ClockUpTips?
    http://aspnet-core.clock-up.jp/contents/controller/action-filter

MVC †

Microsoft.AspNetCore?.Mvc

Controllerクラス †

• 上記のFiltersの影響により、一部のメソッドにインターフェイスの変更がある。

WebAPI †

Controllerクラス †

• ベースクラスが、MVCのControllerと統合された。

• 上記のFiltersの影響により、一部のメソッドにインターフェイスの変更がある。

Filter、FilterAttribute?クラス †

• ASP.NET Core - 実際の ASP.NET Core MVC フィルター
  https://msdn.microsoft.com/ja-jp/magazine/mt767699.aspx
• Azure ServiceFabric? - Asp.Net WebApi?をCore化した時のメモ - Qiita
  https://qiita.com/Yossan/items/e2beb926c0bab31912be

参考 †

.NET Standardは、.NET Coreのサブセットなので、≒.NET Core。
なので、以下のリンクは、.NET Coreへの移行の情報を含む。

.NET Standard 2.0以降 †

.NET Standard 2.1 †

• Visual Studio 2019で.NET Core 3.0 (Preview)を使うときの環境設定 - Qiita
  https://qiita.com/tanitanin/items/c21783403c349a23d11b

内部リンク †

.NET Coreへの移行 †

ASP.NET Coreへの移行 †

microsoft.com †

Microsoft Docs †

• .NET Framework から .NET Core への移植
  https://docs.microsoft.com/ja-jp/dotnet/core/porting/
  • プロジェクトを整理し、.NET Framework と .NET Core をサポートする
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/project-structure
  • .NET Core への移植 - サードパーティの依存関係を分析する
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/third-party-deps
  • .NET Core への移植 - ライブラリ
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/libraries
  • .NET Core に移植する - Windows 互換機能パックの使用
    https://docs.microsoft.com/ja-jp/dotnet/core/porting/windows-compat-pack

MSDN magazine > Essential .NET †

• .NET Core における構成
  https://msdn.microsoft.com/ja-jp/magazine/mt632279.aspx
• .NET Core によるログ記録
  https://msdn.microsoft.com/ja-jp/magazine/mt694089.aspx
• .NET Core による依存関係の挿入
  https://msdn.microsoft.com/ja-jp/magazine/mt707534.aspx
• Visual Studio 2015 と .NET Core ツール
  https://msdn.microsoft.com/magazine/mt736459
• .NET Core 1.0 によるコマンドライン処理
  https://msdn.microsoft.com/magazine/mt763239

.NET API Browser †

https://docs.microsoft.com/en-us/dotnet/api/index

• .NET Standard API Reference
  https://docs.microsoft.com/en-us/dotnet/api/index?view=netstandard-2.0

---

Tags: :.NET開発, :.NET Core, :.NET Standard, :移行

     

Site admin: dotNetDevelopmentInfrastructure

PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 5.3.3. HTML convert time: 0.063 sec.