Actualizar versiones de los controladores

Versión 2.28.0 Cambio potencialmente importante

• Todos los componentes del controlador .NET/C# tienen nombres seguros. Si utiliza la versión 2.28 o posterior del controlador y su aplicación tiene dependencias que hacen referencia a varias versiones del controlador .NET/C#, debe crear redirecciones de enlace, como se muestra en el siguiente ejemplo:

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

Cambios importantes en la versión 2.21.0

• La firma de la función de Render Los métodos de los constructores de búsqueda de MongoDB cambiaron. El siguiente fragmento de código muestra la firma de la función antes y después del cambio:

  // Render function signature prior to v2.21.0
  Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);
  // Render function signature in v2.21.0 and later
  Render(SearchDefinitionRenderContext<TDocument> renderContext);

Cambios importantes en la versión 2.19.0

• El ObjectSerializer solo permite la deserialización de tipos considerados seguros. Si no se especifica lo contrario, el ObjectSerializer utiliza los tipos devueltos por el ObjectSerializer.DefaultAllowedTypes.

  Para obtener más información ObjectSerializer sobre, consulta las preguntas frecuentes. Para obtener más información DefaultAllowedTypes sobre, consulta la documentación de la API.

• El valor predeterminado LinqProvider se ha cambiado a LINQ3. El valor LinqProvider se puede configurar para LINQ2 en MongoClientSettings, como se muestra en el siguiente ejemplo de código:

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

Cambios importantes en la versión 2.14.0

• Esta versión del controlador MongoDB .NET/C# eliminó la compatibilidad con .NET framework v4.5.2 o anterior; el .NET framework mínimo compatible es v4.7.2.

• Esta versión del Driver MongoDB .NET/C# no es compatible con .NET Standard v1.5; la versión mínima compatible de .NET Standard es v2.0.

Cambios importantes en la versión 2.13.0

• Se eliminó la opción de cadena de conexión slave0k; ahora se utiliza la opción readPreference en su lugar.

Versión del servidor 8.1 Cambios de soporte

No se puede usar la versión v2.14.1 ni versiones anteriores del controlador .NET/C# para conectarse a una implementación que ejecute MongoDB Server v8.1. A partir de MongoDB Server v8.1, el comando buildinfo requiere autenticación, lo que provoca una incompatibilidad con estas versiones del controlador.

Cambios de soporte de la versión 2.14

El controlador v2.14 deja de ser compatible con MongoDB Server v3.4 y versiones anteriores. Para usar cualquier controlador de la versión v2.14 y posteriores, su MongoDB Server debe ser v3.6 o posterior.

Para saber cómo actualizar su implementación de MongoDB Server, consulte las Notas de la versión en el manual de MongoDB Server.