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>

Versión 2.21.0 cambio disruptivo

• La firma de función de Render los métodos en los desarrolladores de búsqueda de MongoDB cambiaron. El siguiente snippet 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);

Versión 2.19.0 cambio disruptivo

• 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 sobre ObjectSerializer, visita las Preguntas frecuentes. Para obtener más información sobre DefaultAllowedTypes, visita la Documentación de la API.

• El LinqProvider por defecto se ha cambiado a LINQ3. El LinqProvider puede configurarse 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);

Versión 2.14.0 Cambios importantes

• Esta versión de MongoDB .NET/C# Driver eliminó el soporte para la .NET framework v4.5.2 o anterior; el mínimo .NET framework 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.

Versión 2.13.0 cambio disruptivo

• La opción de cadena de conexión slave0k se eliminó; ahora se utiliza la opción readPreference.

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.

Versión 2.14 Cambios en el soporte de liberación

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 aprender a actualizar tu implementación de MongoDB Server, consulta notas de versión en el manual de MongoDB Server.