Visual Studioで.NETアプリケーションを作成するための設定方法について説明します。なお、データベースへの接続方法については、OSSのドキュメントを参照してください。
.NET Data Providerは、以下の環境で動作可能です。
.NET Frameworkアプリケーションの開発および動作に必要な環境 | .NET 6.0 |
.NET Framework環境で動作するアプリケーションの統合開発環境 | Visual Studio 2022 |
.NET Data Provider、およびNpgsql for Entity Frameworkのセットアップ方法について説明します。
Fujitsu Enterprise Postgresの.NET Data Providerは、ローカルのNuGetパッケージとしてインストール可能です。インストールは、以下の手順で行います。
NuGetパッケージの格納場所
Npgsql NuGetパッケージは、以下に格納されています。“<x>”は製品のバージョンを示します。
<Fujitsu Enterprise Postgresクライアント機能のインストールディレクトリ>\DOTNET\Npgsql.<x>.0.0.nupkg
ローカルパッケージソースの追加
Visual StudioにNuGetローカルパッケージソースがない場合は追加します。
[ツール] - [オプション] - [NuGet パッケージ マネージャー]をクリックし、[パッケージ ソース]を選択します。
右上隅の[+]ボタンをクリックし、[名前]フィールドに“ローカル パッケージ ソース”を入力します。
[...]ボタンをクリックし上記のフォルダを検索します。このフォルダを選択し、[OK]ボタンをクリックします。
NuGetパッケージのインストール
Visual Studioで、ローカルパッケージソースからNuGetパッケージをインストールします。
[ツール] - [NuGet パッケージ マネージャー] - [ソリューションの NuGet パッケージの管理]をクリックします。
右上隅にある[パッケージ ソース]から“ローカルパッケージソース”を選択します。
ローカルパッケージソースを設定すると、このローカルロケーションにある利用可能なすべてのNuGetパッケージが表示されます。“Npgsql”を選択し、このパッケージをインストールするプロジェクトを選択します。
[インストール]をクリックします。
.NET Data Providerは、より多くのデータ型マッピングを可能とするタイププラグインを提供しています (例えば、Npgsql.NodaTimeによる日付/時刻データ型のマッピング)。タイププラグインは、NpgsqlがPostgreSQLの値をCLRの型にマッピングする方法を変更します。
タイププラグインを使用するには、Web上で提供されているNuGetパッケージをインストールして使用してください。
Npgsql for Entity Frameworkは、nugetパッケージマネージャー経由でWeb上からインストールします。以下の条件を満たすNpgsql for Entity Framework をインストールしてください。
Fujitsu Enterprise Postgresで提供されているNpgsqlのバージョンと組み合わせが可能である
Npgsqlコミュニティがサポートしている
最新のマイクロバージョンのものである
.NET Data Providerドライバが自動的にクライアント側の符号化方式をUTF-8に設定するので、符号化方式を設定することはできません。
参照
符号化方式については、“PostgreSQL Documentation”の“Server Administration”の“Automatic Character Set Conversion Between Server and Client”を参照してください。
アプリケーション実行環境の言語設定は、データベースサーバのメッセージロケールの設定と合わせる必要があります。
言語の設定は、System.Globalization.CultureInfo.CreateSpecificCultureメソッドで指定します。
例
C#アプリケーションプログラムでロケールを変更する場合のプログラムソース記述例
System.Threading.Thread.CurrentThread.CurrentUICulture =
System.Globalization.CultureInfo.CreateSpecificCulture("en");Npgsqlのアンインストール方法について説明します。
Npgsqlは、プロジェクト単位でインストールされています。アンインストールは以下の手順で行います。
Visual Studioで、Npgsqlがインストールされているプロジェクトを開きます。
[ツール] - [NuGet パッケージ マネージャー] - [ソリューションの NuGet パッケージの管理]をクリックします。
Npgsqlがインストールされているすべてのプロジェクトを選択し、[アンインストール]をクリックします。
または、プラグインパッケージが削除されている場合は、ソリューションエクスプローラで[依存関係]/ [NuGet]ノードを開き、アンインストールが必要なプラグインを削除します。