作成日: 2024/04/10 最終更新日: 2024/04/10
文書種別
技術情報
詳細
ActiveReports for .NET 18.0J では、NuGetパッケージを利用してランタイムファイルをインストールします。
12.0J以前のバージョンではGACやインストールフォルダの配下(例:C:¥Program Files (x86)¥ActiveReportsNET12¥Bin)に製品のランタイムファイルが配置されていましたが、バージョン14.0Jからは製品のインストールコンテンツにランタイムファイルは含まれていません。プロジェクト単位でNuGetパッケージをインストールする必要があります。
NuGetパッケージのインストール方法については、製品ヘルプの以下のトピックをご参照ください。
依存関係の管理
以下の操作をしたときは、必要なNuGetパッケージが自動でインストールされます。
そのため、複数のソリューションで同一のNuGetパッケージをインストールすると、同一のファイルがそれぞれのpackagesフォルダに保管され、ディスク容量を占有します。
この動作を回避する方法として、NuGetパッケージの管理形式をPackageReferenceに変更する方法が有効です。
以下の手順で既定のパッケージ管理形式を変更できます。
PackageReference形式の場合、NuGetパッケージは開発環境の
また、既にプロジェクトにpackages.configファイルが存在する場合は、以下の手順でPackageReference形式に移行できます。
ただし、PackageReference形式には以下の制限があります。
PackageReference形式の詳細な仕様については、Microsoft社から公開されている技術情報をご参照ください。
NuGet の概要
packages.config から PackageReference への移行
12.0J以前のバージョンではGACやインストールフォルダの配下(例:C:¥Program Files (x86)¥ActiveReportsNET12¥Bin)に製品のランタイムファイルが配置されていましたが、バージョン14.0Jからは製品のインストールコンテンツにランタイムファイルは含まれていません。プロジェクト単位でNuGetパッケージをインストールする必要があります。
NuGetパッケージのインストール方法については、製品ヘルプの以下のトピックをご参照ください。
依存関係の管理
以下の操作をしたときは、必要なNuGetパッケージが自動でインストールされます。
- ActiveReportsのプロジェクトテンプレートを使用して新規にプロジェクトを作成する
- プロジェクトにActiveReportsのレポートを追加する
- 旧バージョンで作成したプロジェクトをファイルコンバータで移行する
.NET Frameworkで使用する場合の注意点
.NET FrameworkのプロジェクトにNuGetパッケージをインストールすると、ソリューションのディレクトリにpackagesフォルダが作成され、パッケージが保管されます。そのため、複数のソリューションで同一のNuGetパッケージをインストールすると、同一のファイルがそれぞれのpackagesフォルダに保管され、ディスク容量を占有します。
この動作を回避する方法として、NuGetパッケージの管理形式をPackageReferenceに変更する方法が有効です。
以下の手順で既定のパッケージ管理形式を変更できます。
- Visual Studio の「ツール」メニューにある「オプション」を選択する
- 「NuGet パッケージマネージャー」の「全般」を選択する
- 既定のパッケージ管理形式を PackageReference に変更する
PackageReference形式の場合、NuGetパッケージは開発環境の
[ユーザーフォルダ]¥.nuget¥packages¥に保管されます。
また、既にプロジェクトにpackages.configファイルが存在する場合は、以下の手順でPackageReference形式に移行できます。
- ソリューションエクスプローラーのpackages.configファイル上で右クリックする
- コンテキストメニューの「packages.config を PackageReference に移行する」を選択する
ただし、PackageReference形式には以下の制限があります。
- ASP.NETのプロジェクトでは使用できません。
PackageReference形式の詳細な仕様については、Microsoft社から公開されている技術情報をご参照ください。
NuGet の概要
packages.config から PackageReference への移行