Docs Menu
Docs Home
/ / /
C#/.NET

ドライバーのバージョンをアップグレードする

項目一覧

  • Overview
  • 重大な変更
  • サーバー リリースの互換性の変更

このセクションでは、ドライバーを新しいバージョンにアップグレードするときにアプリケーションに加える必要がある重要な変更を特定できます。

アップグレードする前に、次のアクションを実行してください。

  • 新しいバージョンが、アプリケーションが接続する MongoDB Server のバージョンと、アプリケーションが実行される.NET フレームワークのバージョンと互換性があることを確認します。 この情報については、 .NET/C# ドライバーの互換性ページを参照してください。

  • アプリケーションが使用しているドライバーの現在のバージョンとアップグレードが予定されているバージョンとの間の重大な変更については、「 重大な変更 」セクションを参照してください。 MongoDB Server リリースの互換性の変更の詳細については、「サーバー リリースの互換性の変更 」セクションを参照してください。

Tip

将来ドライバー バージョンをアップグレードする際にアプリケーションで必要になる変更数を最小限に抑えるには、 Stable API を使用します。

重大な変更とは、ドライバーの特定のバージョン以降の規則または動作の変更です。 このタイプの変更では、ドライバーをアップグレードする前に対処しないと、アプリケーションが正常に動作しなくなる可能性があります。

このセクションの重大な変更は、それを導入したドライバーのバージョンによって分類されます。 ドライバーのバージョンをアップグレードするときは、現在のバージョンとアップグレードのバージョン間のすべての重大な変更に対処してください。 たとえば、ドライバーを v 2.0から v 2.20にアップグレードする場合、v 2.0以降のバージョンからの重大な変更に対処します。 v 2.20にリストされているすべての を含みます。

  • ObjectSerializerは、安全であると見なされる型の逆直列化のみを許可します。 特に指定されていない場合、 ObjectSerializerObjectSerializer.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);
  • この 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です。

  • slave0k 接続stringオプションが削除されました。代わりに readPreference オプションが使用されるようになりました。

サーバー リリースの互換性の変更とは、MongoDB .NET/C# ドライバーに対する変更で、MongoDB Server のバージョンのセットのサポートを廃止します。

ドライバーは、サポート終了(EOL)に達すると、MongoDB Server バージョンのサポートを終了します。

EOL 製品の MongoDB サポートの詳細については、サポート レガシー ポリシー を参照してください。

.NET/C# ドライバーのバージョンと MongoDB Server のバージョンの互換性の詳細については、互換性ページをご覧ください。

戻る

互換性