Atualize para a versão 2.x

Visão geral

Esta página descreve as alterações que você pode precisar fazer no seu aplicação ao atualizar o driver .NET/C# para a versão 2.x.

Como fazer a atualização

Cada seção desta página lista as possíveis alterações significativas introduzidas por uma versão de driver. Para atualizar o driver .NET/C# para a versão 2.x, siga estas etapas:

Revise a página Compatibilidade para garantir que a nova versão do driver seja compatível com as versões do MongoDB Server às quais seu aplicação se conecta e com a versão da estrutura .NET ou .NET em que seu aplicação é executado.
Resolva quaisquer alterações significativas entre a versão do driver que seu aplicação usa e a versão de atualização de destino na seção Alterações significativas por versão .
Exemplo
Se você estiver atualizando o driver da v2.14 para a v2.21, resolva todas as alterações significativas da versão após a v2.14 (v2.19), incluindo quaisquer alterações para v2.21.

Alterações significativas por versão

As seções a seguir descrevem as possíveis alterações significativas introduzidas por cada versão do driver. Se uma versão do driver não estiver incluída nesta seção, ela não introduzirá nenhuma alteração significativa.

Versão 2.28.0 alteração interruptiva

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>

Versão 2.21.0 Alterações interruptivas

O driver altera a assinatura dos métodos Render nos construtores do Atlas 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);
```

Versão 2.19.0 Alterações interruptivas

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.

alteração interruptiva na versão 2.14.0

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.

Voltar

atualização

Versão 3.0