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