バージョン 2 .x にアップグレード

項目一覧

Overview

アップグレード方法
バージョン別の重大な変更
バージョン 2.28.0重大な変更
バージョン2.21.0 重大な変更
バージョン2.19.0 重大な変更
バージョン 2.14.0 重大な変更

Overview

このページでは、 .NET/ C#ドライバーをバージョン 2 .x にアップグレードするときにアプリケーションに加える必要がある変更について説明します。

アップグレード方法

このページの各セクションでは、ドライバーバージョンによって導入される可能性のある重大な変更を一覧にしています。 .NET/ C#ドライバーをバージョン 2 .x にアップグレードするには、次の手順に従います。

[ 互換性 ] ページを確認して、新しいドライバーバージョンが、アプリケーションが接続するMongoDB Serverのバージョンおよびアプリケーションが実行される.NETまたは.NETフレームワークのバージョンと互換性があることを確認します。
アプリケーションで使用されるドライバーバージョンとターゲットのアップグレードバージョン間の重大な変更については、バージョン別の重大な変更セクションを参照してください。
例
ドライバーを v2.14 から v2.21 にアップグレードする場合は、 v 以降のバージョンからのすべての重大な変更に対処します。2.14（v 2.19 ）、v 2.21 の変更を含む。

バージョン別の重大な変更

次のセクションでは、各ドライバーバージョンによって導入される可能性のある重大な変更について説明します。このセクションにドライバーのバージョンが含まれていない場合は、重大な変更は導入されません。

バージョン 2.28.0重大な変更

ドライバーは、すべてのドライバーコンポーネントに対して強力な名前を使用します。アプリケーションに複数の.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>

バージョン2.21.0 重大な変更

ドライバーは、Atlas Search ビルダの Render メソッドの署名を変更します。以前のドライバーバージョンでは、これらのメソッドは次の署名を持っていました。
```
Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);
```
バージョン 2.21.0 以降では、Render メソッドは次の署名を持ちます。
```
Render(SearchDefinitionRenderContext<TDocument> renderContext);
```

バージョン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 Server v 3.4 以前のサポートを削除します。MongoDB Serverは v 3.6 以降にアップグレードする必要があります。
MongoDB Server配置をアップグレードする方法については、 MongoDB Serverマニュアルのリリースノートを参照してください。.NET/ C#ドライバーとMongoDB Server間の互換性の詳細については、互換性ページを参照してください。
ドライバーは.NETフレームワークv 4.5.2 以前のサポートを削除します。アプリケーションでは、 .NET フレームワーク v 4.7.2 以降、 .NET Core 2 .x 以降、 .NET 5 以降を使用する必要があります。
.NET/ C#ドライバーと.NET間の互換性の詳細については、互換性ページを参照してください。
ドライバーは.NET Standard v 1.5 のサポートを削除します。アプリケーションでは、 .NET Standard v 2.0 以降を使用する必要があります。

戻る

アップグレード

バージョン 3.0