Actualizar a la versión 2.x

El controlador utiliza nombres seguros para todos sus componentes. Si 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>

El conductor cambia la firma de Render Métodos en los constructores de búsqueda de MongoDB. En versiones anteriores del controlador, estos métodos tenían la siguiente firma:

Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);

En la versión 2.21.0 y posteriores, los métodos Render tienen la siguiente firma:

Render(SearchDefinitionRenderContext<TDocument> renderContext);

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, visite el sitio web Preguntas frecuentes. Para obtener más información sobre,DefaultAllowedTypes visita 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);

Si su aplicación usa el3 proveedor LINQ, no podrá usar -1 para representar el operador posicional al actualizar un array. Para aprender a usar el operador posicional, consulte Actualizar uno y Actualizar muchos.

El controlador ya no es compatible con MongoDB Server v3.4 y versiones anteriores. Debe actualizar su MongoDB Server a 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. Para obtener más información sobre la compatibilidad entre el controlador .NET/C# y MongoDB Server, consulte la página de Compatibilidad.

El controlador ya no es compatible con .NET Framework v4.5.2 y versiones anteriores. Su aplicación debe usar .NET Framework v4.7.2 o posterior, .NET Core 2.x o posterior, o .NET 5 o posterior.

Para obtener más información sobre la compatibilidad entre el controlador .NET/C# y .NET, consulte la página Compatibilidad.

El controlador ya no es compatible con .NET Standard v1.5. Su aplicación debe usar .NET Standard v2.0 o posterior.