MESCIUS PlusPak for Windows Forms 12.0J > はじめに > .NET プロジェクトで使用する場合のご注意 > プロジェクトの作成とアセンブリ参照の追加 |
.NET プロジェクトを作成するには、Visual Studio の「Windows フォーム アプリ」プロジェクトテンプレートを使用してプロジェクトを作成します。作成したプロジェクトにて本製品のコンポーネントを使用するには、プロジェクトに本製品のアセンブリへの参照を追加する必要がありますが、.NET Framework プロジェクトのようにアセンブリファイル(*.dll)への参照を直接追加するのではなく、代わりにそれらのコンポーネントに対応する NuGet パッケージをインストールすることになります。
例として、Visual Studio 2022 にて.NET6の新規プロジェクトを作成し、NuGet パッケージをインストールするまでの手順を以下に示します。
スタート画面で「新しいプロジェクトの作成」を選択します。または、メインメニューから[ファイル]-[新規作成]-[プロジェクト]を選択します。
「新しいプロジェクトの作成」画面にて、「Windows フォーム アプリ」を選択します。
プロジェクト名およびソリューション名を指定し、次へボタンをクリックします。
ターゲットフレームワークとして「.NET6」を指定し、作成ボタンをクリックします。
これにより、プロジェクトおよびソリューションが作成され、生成されたソリューションの内容がソリューションエクスプローラーに表示されます。
画面右上にある「パッケージソース」を「nuget.org」に設定します。
参照タブに切り替え、検索ボックスに「MESCIUS.Win.PlusPak」と入力すると、本製品の NuGet パッケージが表示されます。
本製品の NuGet パッケージ(MESCIUS.Win.PlusPak)を選択します。
使用するバージョンを選択し、インストールボタンをクリックします。依存関係にある NuGet パッケージが検出され、それら含めたライセンスの同意画面が表示されるので、続行する場合は同意するボタンをクリックします。
本製品のNuGetパッケージをインストールすると、本製品の以下のアセンブリファイルと System.Text.Encoding.CodePages のパッケージがプロジェクトの依存関係に追加されます。
|
.NET プロジェクトで本製品を使用する場合は、アプリケーションの開始時に以下のコードを実行する必要があります。 System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance); 本製品の NuGet パッケージをインストールした後に、プログラムの Main() メソッドなどに追加してください。 |
本製品の NuGet パッケージファイルは、本製品のインストール先フォルダにある「Package」フォルダに保存されています。
インターネットに接続されていない環境では、それら NuGet パッケージファイルを任意のフォルダにコピーし、下記の手順に従って NuGet パッケージソースを追加してから、本製品の NuGet パッケージをインストールしてください。
以上の手順で作成した「パッケージソース」を、「NuGet パッケージのインストール」の手順2の「パッケージソース」として指定すると、本製品の NuGet パッケージが参照できるようになります。
本製品を利用する場合は、依存パッケージとして System.Text.Encoding.CodePages が必要になります。インターネットに接続されていない環境で本製品を利用する場合は、インターネットに接続可能な別の環境にてこのパッケージを入手し、本製品の NuGet パッケージと同じパッケージソースフォルダにコピーしてください。 |