Menu Docs
Página inicial do Docs
/
Idiomas
/
C#/.NET
/
C#/.NET

Atualizar versões do driver

Nesta página

  • Visão geral
  • Mudanças de última hora
  • Alterações na compatibilidade da versão do servidor

Visão geral

Nesta seção, você pode identificar as alterações essenciais que devem ser feitas no seu aplicativo ao atualizar seu driver para uma nova versão.

Antes de atualizar, execute as seguintes ações:

  • Certifique-se de que a nova versão 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 em que seu aplicação é executado. Consulte a página Compatibilidade do driver .NET/C# para obter essas informações.

  • Resolva quaisquer alterações interruptivas entre a versão atual do driver que seu aplicativo está usando e a versão de atualização planejada na seção alterações interruptivas. Para saber mais sobre as alterações de compatibilidade da versão do Servidor MongoDB, consulte a seção Alterações de compatibilidade da versão do servidor.

Dica

Para minimizar o número de alterações que seu aplicativo pode exigir ao atualizar versões de drivers no futuro, use a API Stable.

Mudanças de última hora

Uma alteração interruptiva é uma modificação de uma convenção ou de um comportamento que começa em uma versão específica do driver. Esse tipo de alteração pode impedir que seu aplicativo funcione corretamente se não for resolvido antes de atualizar o driver.

As alterações interruptivas nesta seção são categorizadas pela versão do driver que as introduziram. Ao atualizar as versões do driver, resolva todas as alterações interruptivas entre a versão atual e a atualizada. Por exemplo, se você estiver atualizando o driver de v2.0 para v2.20, resolva todas as alterações interruptivas da versão após v2.0 incluindo qualquer um listado em v2.20.

Versão 2.19.0 Alterações interruptivas

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

    Para saber mais sobre o ObjectSerializer, visite as Perguntas frequentes. 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);

alteração interruptiva na versão 2.14.0

  • Essa versão do driver MongoDB .NET/C# removeu a compatibilidade com .NET framework v4.5.2 ou anterior; o framework.NET mínimo compatível é v4.7.2.

  • Esta versão do driver MongoDB .NET/C# não suporta o .NET Standard v1.5; o .NET Standard mínimo suportado é v2.0.

Versão 2.13.0 Alterações interruptivas

  • A opção de connection string do slave0k foi removida; a opção readPreference agora é usada.

Alterações na compatibilidade da versão do servidor

Uma alteração de compatibilidade de versão do servidor é uma modificação no driver .NET/C# do MongoDB que descontinua o suporte para um conjunto de versões do MongoDB Server.

O driver interrompe o suporte para uma versão do Servidor MongoDB após atingir o fim da vida útil (EOL).

Para saber mais sobre o suporte MongoDB para produtos EOL, consulte a Política de Suporte Legado.

Para saber mais sobre a compatibilidade entre as versões do driver .NET/C# e as versões do MongoDB Server, visite a página de compatibilidade.

Versão 2.14 Alterações na compatibilidade com a versão

  • O driver v2.14 elimina o suporte para o MongoDB Server v3.4 e anteriores. Para usar qualquer driver da v2.14 e posterior, seu MongoDB Server deve ser v3.6 ou mais tarde. Para saber como atualizar seu MongoDB Server para v3.6, siga o link que corresponde à sua configuração de deployment do MongoDB :

Voltar

Compatibilidade