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にリストされているすべての を含みます。

  • すべての .NET/C# ドライバー コンポーネントには厳密に名前が付けられます。 ドライバー バージョン2.28以降を使用しており、アプリケーションに複数の .NET/C# ドライバー バージョンを参照する依存関係がある場合は、次の例に示すように、バインディング リダイレクトを作成する必要があります。

    <configuration>
    <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
    <assemblyIdentity name="MongoDB.Driver"
    publicKeyToken="94992a530f44e321"
    culture="neutral" />
    <bindingRedirect oldVersion="2.28.0.0"
    newVersion="<version number to use>" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="MongoDB.Bson"
    publicKeyToken="94992a530f44e321"
    culture="neutral" />
    <bindingRedirect oldVersion="2.28.0.0"
    newVersion="<version number to use>" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="MongoDB.Driver.Core"
    publicKeyToken="94992a530f44e321"
    culture="neutral" />
    <bindingRedirect oldVersion="2.28.0.0"
    newVersion="<version number to use>" />
    </dependentAssembly>
    </assemblyBinding>
    </runtime>
    </configuration>
  • Atlas Search ビルダの Renderメソッドの関数署名が変更されました。 次のコード スニペットは、変更前と変更後の関数シグネチャを示しています。

    // Render function signature prior to v2.21.0
    Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);
    // Render function signature in v2.21.0 and later
    Render(SearchDefinitionRenderContext<TDocument> renderContext);
  • 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 のバージョンの互換性の詳細については、互換性ページをご覧ください。

v 2.14ドライバーは MongoDB Server v 3.4以前のサポートを削除します。 v 2.14以降の任意のドライバーを使用するには、MongoDB Server は v 3.6である必要があります 以降に更新します。

MongoDB Server 配置をアップグレードする方法については、MongoDB Server マニュアルのリリースノートを参照してください。

戻る

互換性