Atualize para a versão 2.x

O driver usa nomes fortes para todos os componentes do driver. Se o seu aplicação tiver dependências que façam referência a várias versões do driver .NET/C#, será necessário criar redirecionamentos de associação, conforme mostrado no exemplo a seguir:

<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>

O driver altera a assinatura dos métodos do Render nos construtores do MongoDB Search. Nas versões anteriores do driver, esses métodos tinham a seguinte assinatura:

Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);

Na versão 2.21.0 e posterior, os métodos Render têm a seguinte assinatura:

Render(SearchDefinitionRenderContext<TDocument> renderContext);

O ObjectSerializer só permite a desserialização dos tipos que são considerados seguros. Se não for especificado de outra forma, o ObjectSerializer utiliza os tipos retornados pelo ObjectSerializer.DefaultAllowedTypes.

Para saber mais sobre o ObjectSerializer, acesse as Perguntas frequentes do FAQ. Para obter mais informações sobre DefaultAllowedTypes, acesse a documentação da API.

O padrão LinqProvider foi alterado para LINQ3. O LinqProvider pode ser configurado para LINQ2 em MongoClientSettings como mostrado no exemplo de código a seguir:

var connectionString = "<connection string>";
var clientSettings = MongoClientSettings
   .FromConnectionString(connectionString);
clientSettings.LinqProvider = LinqProvider.V2;
var client = new MongoClient(clientSettings);

Se seu aplicação usa o3 provedor LINQ, você não pode usar -1 para representar o operador posicional ao atualizar uma array. Para saber como usar o operador posicional, consulte Atualizar um e Atualizar muitos.

O driver elimina o suporte para o MongoDB Server v3.4 e versões anteriores. Você deve atualizar seu MongoDB Server para v3.6 ou posterior.

Para saber como atualizar seu sistema do MongoDB Server, consulte Notas de versão no manual do MongoDB Server. Para saber mais sobre compatibilidade entre o driver .NET/C# e o MongoDB Server, consulte a página Compatibilidade.

O driver elimina o suporte para .NET framework v4.5.2 e anteriores. Seu aplicação deve usar o .NET framework v4.7.2 ou posterior, .NET Core 2.x ou posterior ou .NET 5 ou posterior.

Para saber mais sobre compatibilidade entre o Driver .NET/C# e .NET, consulte a página Compatibilidade.

O driver elimina o suporte para o .NET Standard v1.5. Seu aplicação deve usar o .NET Standard v2.0 ou posterior.