Microsoft.Data.SqlClient で 「System.PlatformNotSupportedException: Microsoft.Data.SqlClient is not supported on this platform.」 エラーが発生する

SqlClient で 「System.PlatformNotSupportedException: Microsoft.Data.SqlClient is not supported on this platform.」 エラーが発生する現象と対処法を紹介します。

現象

新しい特定の環境でデータベース接続時に以下のエラーが発生します。

Exception: 
System.PlatformNotSupportedException: Microsoft.Data.SqlClient is not supported on this platform.
   at Microsoft.Data.SqlClient.SqlConnectionStringBuilder..ctor()
  ...(以下略)...

エラーが発生するとそのプログラムでは、100%エラーになります。
エラーが発生しないプログラムもあります。

今回の事例では、以下のコードでエラーが発生しました。

SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();

原因

不明です。新しい環境(Windows Server 2025, .NET 9)で発生しやすい傾向があります。

対処法

2つあります。

対処法1: Microsoft.Data.SqlClient をプレリリース版にアップデートする

Microsoft.Data.SqlClient をプレリリース版 (6.0.0-preview3.xxx) にアップデートすると解消される場合があります。

対処法2: System.Data.SqlClient に変更する

Microsoft.Data.SqlClientから、System.Data.SqlClient に変更すると解消される場合があります。
(この方法の場合、コードエディタで「古い形式です」のアラートが表示されます。)

著者

neg

iPentec.com の代表。ハードウェア、サーバー投資、管理などを担当。
Office 365やデータベースの記事なども担当。