ドライバーのバージョンをアップグレードする
Overview
このセクションでは、ドライバーを新しいバージョンにアップグレードするときにアプリケーションに加える必要がある重要な変更を特定できます。
アップグレードする前に、次のアクションを実行してください。
新しいバージョンが、アプリケーションが接続する MongoDB Server のバージョンと、アプリケーションが実行される.NET フレームワークのバージョンと互換性があることを確認します。 この情報については、 .NET/C# ドライバーの互換性ページを参照してください。
アプリケーションが使用しているドライバーの現在のバージョンとアップグレードが予定されているバージョンとの間の重大な変更については、「 重大な変更 」セクションを参照してください。 MongoDB Server リリースの互換性の変更の詳細については、「サーバー リリースの互換性の変更 」セクションを参照してください。
Tip
将来ドライバー バージョンをアップグレードする際にアプリケーションで必要になる変更数を最小限に抑えるには、 Stable API を使用します。
重大な変更
重大な変更とは、ドライバーの特定のバージョン以降の規則または動作の変更です。 このタイプの変更では、ドライバーをアップグレードする前に対処しないと、アプリケーションが正常に動作しなくなる可能性があります。
このセクションの重大な変更は、それを導入したドライバーのバージョンによって分類されます。 ドライバーのバージョンをアップグレードするときは、現在のバージョンとアップグレードのバージョン間のすべての重大な変更に対処してください。 たとえば、ドライバーを v 2.0から v 2.20にアップグレードする場合、v 2.0以降のバージョンからの重大な変更に対処します。 v 2.20にリストされているすべての を含みます。
バージョン2.19.0 重大な変更
ObjectSerializer
は、安全であると見なされる型の逆直列化のみを許可します。 特に指定されていない場合、ObjectSerializer
はObjectSerializer.DefaultAllowedTypes
によって返された型を使用します。ObjectSerializer
の詳細については、 FAQをご覧ください。DefaultAllowedTypes
の詳細については、 API ドキュメント をご覧ください。デフォルトの
LinqProvider
は LINQ 3に変更されました。 次のコード例に示すように、MongoClientSettings
で LINQ 2用にLinqProvider
を構成することができます。var connectionString = "<connection string>"; var clientSettings = MongoClientSettings .FromConnectionString(connectionString); clientSettings.LinqProvider = LinqProvider.V2; var client = new MongoClient(clientSettings);
バージョン 2.14.0 重大な変更
この MongoDB .NET/C# ドライバーのバージョンでは、.NET フレームワーク v 4.5.2またはそれ以前のバージョンのサポートが削除されました。サポートされる最小の .NET フレームワークは v 4.7.2です。
このバージョンの MongoDB .NET/C# ドライバーは .NET Standard v 1.5をサポートしていません。サポートされる最小の .NET 標準は v 2.0です。
バージョン2.13.0 重大な変更
slave0k
接続stringオプションが削除されました。代わりにreadPreference
オプションが使用されるようになりました。
サーバー リリースの互換性の変更
サーバー リリースの互換性の変更とは、MongoDB .NET/C# ドライバーに対する変更で、MongoDB Server のバージョンのセットのサポートを廃止します。
ドライバーは、サポート終了(EOL)に達すると、MongoDB Server バージョンのサポートを終了します。
EOL 製品の MongoDB サポートの詳細については、サポート レガシー ポリシー を参照してください。
.NET/C# ドライバーのバージョンと MongoDB Server のバージョンの互換性の詳細については、互換性ページをご覧ください。
バージョン2.14 サポートの変更をリリース
v 2.14ドライバーは MongoDB Server v 3.4以前のサポートを削除します。 v 2.14以降の任意のドライバーを使用するには、MongoDB Server は v 3.6である必要があります 以降に更新します。 MongoDB Server を v 3.6にアップグレードする方法については、MongoDB 配置構成に対応するリンクを参照してください。