Descubra as novidades de cada versão:
Importante
Para garantir que o número da versão principal do fornecedor esteja alinhado com as versões do Entity Framework Core, o fornecedor do MongoDB Entity Framework Core não limita as alterações significativas às versões principais. Em vez disso, alterações significativas e significativas são feitas em versões menores.
Novidades no 8.4
Esta seção lista as alterações introduzidas nas seguintes versões:
Versão 8.4.4
O 8.4.4 a versão do provedor inclui as seguintes alterações:
Importante
A versão v8.4.4 do MongoDB Entity Framework Core provedor inclui correções para os seguintes problemas de segurança:
For the latest information about MongoDB security updates, see MongoDB Security Bulletins.
Corrige a geração de esquema do Queryable Encryption ao especificar um nome de banco de dados
Para de registrar a string de conexão para evitar divulgações não intencionais
Corrige um catch vazio
AssertTranslationFailedque mascarava dados incorretos nas suítes de especificação do IncludeCorrige duas referências de mesmo nível (sibling) que incluem o mesmo tipo de entidade de destino
Corrige chamares de
ThenIncludeirmãos através do mesmo tipo de destino que colapsam em um$lookupCorrige um salto
ThenIncludetransitivo roteado incorretamente para uma navegação de isca de nível raizCorrige uma entidade de junção muitos-para-muitos que perde uma chave composta para uma propriedade de sombra duplicada
Corrige um
ThenIncludecujo seletor de chave acessa através de uma navegação de propriedadeCorrige
Take(0)lançando umArgumentOutOfRangeExceptionCorrige
Equals()com tipos numéricos incompatíveis que geram umInvalidCastExceptionAtualiza o driver .NET/C# para 3.11.2
Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.4 no Github.
Versão 8.4.3
O 8.4.3 a versão do provedor inclui as seguintes alterações:
Importante
A versão v8.4.3 do MongoDB Entity framework Core provedor inclui uma correção para CVE-2026-92756.
For the latest information about MongoDB security updates, see MongoDB Security Bulletins.
Adiciona suporte para
Include()chamar, navegações e junções entre coleçõesAdiciona suporte para operadores LINQ como
ToArray(),ToList()eFirstOrDefault()aplicados a uma string na projeção finalAdiciona suporte para a criação de índices de pesquisa MongoDB
Adiciona metadados ao instanciado
MongoClientRejeita tokens de concorrência em entidades próprias
Corrige uma leitura de
EF.Property()sombra ou escalar em uma entidade associada em uma projeçãoCorrige um bug em que um valor calculado que combina duas propriedades (por exemplo,
c.Age * c.Score) retornava um resultado incorreto quando projetado junto com uma entidade inteira.Corrige os filtros discriminadores LINQ do driver para corresponder aos valores convertidos ou representados
Corrige um bug em que o construtor de cópia
MongoOptionsExtensiondescartava as configuraçõesCryptExtraOptionseQueryableEncryptionSchemaModequando encadeado após os métodosWithCryptProvider()ouWithQueryableEncryptionSchemaMode()Corrige uma query compilada que termina em um operador de query
Corrige um bug onde a chamada de
Sum()em um conjunto vazio retornavanullpara projeções anuláveisCorrige um bug em que chamar
Contains()em uma coleção escalar projetada retornava resultados incorretosAtualiza a dependência da versão do Entity Framework Core para 8.0.30
Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.3 no Github.
Versão 8.4.2
O 8.4.2 a versão do provedor inclui as seguintes alterações:
Melhora a projeção
Select()para oferecer suporte à mistura de seleções de campo e de nível de entidadeAdiciona suporte para comparar entidades entre si e com nulo
Reescreve a lógica de vinculação para ser mais robusta com formas não triviais e melhor suportar projeções
Select()Adiciona suporte para
String.Replace()eString.Compare()por meio de melhorias no driver MongoDB .NET/C# subjacenteCorrige um bug em que
HasAtlasIndexesverificava apenas a primeira entidade de propriedade em vez de todas as entidades de propriedadeCorrige mensagens de log que relataram
ExecutingBulkWritecomoExecutedcom um tempo decorrido incorreto e que não incluíam os valores pretendidosCorrige conversões inválidas em caminhos de construtores fluentes raramente usados para
Decimal128eQueryableEncryptionType
Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.2 no Github.
Versão 8.4.1
O 8.4.1 a versão do provedor inclui as seguintes alterações:
- Corrige um erro para salvar alterações em uma coleção quando um item é removido
Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.1 no Github.
Versão 8.4.0
O 8.4.0 a versão do provedor inclui as seguintes alterações:
Mapeia o discriminador para
_t, a menos que tenha sido explicitamente configuradoMelhora a detecção e o envio de mensagens de operações LINQ não compatíveis
Usa consistentemente o EF Core em vez do EF
Para obter mais informações sobre esta versão, consulte as notas de versão v8.4.0 no Github.
Novidades no 8.3
Esta seção lista as alterações introduzidas nas seguintes versões:
Versão 8.3.4
O 8.3.4 a versão do provedor inclui as seguintes alterações:
Adiciona suporte para traduzir o método
DateTime.Compare()em queries LINQAdiciona o parâmetro
CreateCollectionOptionsà estruturaMongoDatabaseCreationOptionsAdiciona suporte para v3.6 do MongoDB .NET/C# Driver
Corrige um bug em que collections BSON vazias não resultavam em collections CLR vazias quando você usava a opção
QueryTrackingBehavior.NoTrackingCorrige uma exceção de descarte que ocorreu dentro do método
CreateExecutionStrategy().ExecuteInTransaction
Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.4 no Github.
Versão 8.3.3
O 8.3.3 a versão do provedor inclui as seguintes alterações:
Adiciona suporte a transações explícitas usando as interfaces
MongoTransactionManagereIMongoTransactionManagerAumenta o tempo limite padrão para a criação de índices vetoriais de 15 para 60 segundos e registra quando o sistema está aguardando a conclusão do processo
Corrige a lógica de registro para garantir que, quando o registro de dados confidenciais estiver desativado, as mensagens de aviso de query vetorial não incluam os detalhes de query sensível
Atualiza os campos de filtro de índice vetorial para usar nomes de elementos em vez de nomes de propriedade C#
Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.3 no Github.
Versão 8.3.2
O 8.3.2 a versão do provedor inclui as seguintes alterações:
Adds support for MongoDB Vector Search. To learn more, see MongoDB Vector Search Overview in the MongoDB Server manual.
Torna públicas as classes de convenções do fornecedor.
Corrige um bug em que as projeções que usam o método
EF.Property()geraram um erroNullReferenceException.
Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.2 no Github.
Versão 8.3.1
O 8.3.1 a versão do provedor inclui as seguintes alterações:
Adiciona suporte a esquema do lado do servidor e uma nova API fluente
IsEncryptedpara Queryable EncryptionAdiciona suporte para chaves alternativas
Permite a supressão de exceção quando uma propriedade de tipo de entidade tem o atributo
ColumnAttributeAdiciona suporte de seeding de banco de dados por meio do método
EnsureCreated()Adiciona suporte para mapeamento de estruturas simples que são usadas como propriedades simples
Adiciona suporte para materializar propriedades de somente leitura
Adiciona suporte para propriedades de sombra como chaves primárias
Para obter mais informações sobre esta versão, consulte as notas de versão v8.3.1 no Github.
Versão 8.3.0
A versão do fornecedor 8.3 inclui as seguintes novas funcionalidades:
Adiciona suporte para configurar a representação de BSON no
PropertiesConfigurationBuilder.Adiciona suporte de nível de configuração para
HasDateTimeKind().Altera o comportamento para aplicar
HasBsonRepresentationa propriedades anuláveis. Para saber mais, consulte o guia da versão 8.3.0 Alterações significativas no upgrade da versão do provedor.Altera o comportamento para permitir testes de nulidade para collections de navegação.
Novidades no 8.2
Esta seção lista as alterações introduzidas nas seguintes versões:
Versão 8.2.3
O 8.2.3 a versão do provedor inclui as seguintes novas funcionalidades:
Adiciona suporte para agregações escalares de nível superior, como
Sum,Average,MineMaxAdiciona suporte para a geração
ObjectIdao usar o tipostringpara a propriedade_idAltera o comportamento para não gerar mais um erro quando o elemento BSON está ausente em uma coleção própria
Versão 8.2.2
O 8.2.2 a versão do provedor inclui as seguintes novas funcionalidades:
Atualiza a mensagem de erro
DbUpdateConcurrencyExceptionpara incluir os tipos de entidades responsáveis pelo erroAdiciona suporte para conversores de valor em relação a propriedades anuláveis
Adiciona suporte para usar o método
HasIndex()em entidades própriasAdiciona suporte para tipos de array de bytes
Versão 8.2.1
O 8.2.1 a versão do provedor inclui as seguintes novas funcionalidades:
Adiciona suporte para propriedades de sombra do Entity Framework, propriedades que não são definidas em sua classe de entidade .NET, mas estão incluídas no modelo Entity Framework Core e mapeadas para o banco de dados.
Adiciona suporte para o uso do método HasIndex() Entity Framework Fluent API para criar índices para uma propriedade quando você cria um banco de dados.
O exemplo seguinte mostra como especificar índices para as propriedades
Customer.Name,Order.OrderRef,Address.ZipCodeeDocuments.DocRef:var context = MyContext.CreateCollectionOptions(database.MongoDatabase, mb => { mb.Entity<Customer>().HasIndex(c => c.Name); mb.Entity<Order>().HasIndex(o => o.OrderRef).IsUnique(); mb.Entity<Address>().HasIndex(o => o.ZipCode, "custom_index_name"); mb.Entity<Documents>() .HasIndex(d => d.DocRef) .HasCreateIndexOptions(new CreateIndexOptions { Sparse = true }); }); var result = context.Database.EnsureCreated(); Adiciona suporte para os métodos MQL.Exists(), MQL.IsMissing() e MQL.IsNullOrMissing() em queries LINQ. Esses métodos funcionam com propriedades reais e de sombra.
Versão 8.2.0
A versão do fornecedor 8.2 inclui as seguintes novas funcionalidades:
Adiciona suporte para discriminadores de tipo
Adiciona suporte para v3.0 do MongoDB .NET/C# Driver
Adiciona suporte para tipos de CLR do
TimeOnlyeDateOnly
Novidades no 8.1
Aviso
Mudanças de última hora
O fornecedor v8.1 introduz as seguintes alterações significativas:
O EF Core Provider executa todas as alterações como transações MongoDB . Se o seu aplicação usa uma versão do MongoDB Server anterior à v5.0, ou não for executado em um conjunto de réplicas, será necessário reconfigurar seu aplicação.
O formato de armazenamento GUID padrão foi alterado do formato
CSharpLegacybinário para o formatoStandard.Modificou a interface do
IMongoClientWrapperpara fornecer registro de serviço para a classeMongoClientWrapper. Você não deve implementar a interfaceIMongoClientWrapperem seu aplicação.Os casos
CamelCaseElementNameConventionpossuem entidades com base no nome da propriedade em vez do nome da classe .
Para obter mais informações sobre essas alterações significativas, consulte a versão 8.1.0 Alterações significativas no guia da versão do provedor de atualização.
A versão do fornecedor 8.1 inclui as seguintes novas funcionalidades:
Suporte para simultaneidade otimista através do seguinte:
IsConcurrencyToken()método ou o atributoConcurrencyCheck()IsRowVersion()método ou o atributoTimestamp
Suporte para mapear propriedades do
DictionaryeReadOnlyDictionary
Para obter mais informações sobre esta versão, consulte as notas de versão v8.1.0.