Docs Menu
Docs Home
/
언어
/
C#/.NET
/
C#/.NET
/
업그레이드

버전 2.x로 업그레이드

이 페이지의 내용

  • 개요
  • 업그레이드 방법
  • 버전별 단절적 변경 사항
  • 버전 2.28.0 호환성이 손상되는 변경
  • 버전 2.21.0 호환성이 손상되는 변경
  • 버전 2.19.0 호환성이 손상되는 변경
  • 버전 2.14.0 호환성이 손상되는 변경

개요

이 페이지에서는 .NET/ C# 드라이버 를 버전 2.x로 업그레이드 할 때 애플리케이션 에 적용해야 할 변경 사항에 대해 설명합니다.

업그레이드 방법

이 페이지의 각 섹션에는 운전자 버전으로 인해 발생할 수 있는 잠재적인 호환성이 손상되는 변경이 나열되어 있습니다. .NET/ C# 드라이버 를 버전 2.x로 업그레이드 하려면 다음 단계를 따르세요.

  1. 호환성 페이지를 검토하여 새 운전자 버전이 애플리케이션 이 연결되는 MongoDB Server 버전 및 애플리케이션 이 실행되는 .NET 또는 .NET 프레임워크 버전과 호환되는지 확인합니다.

  2. 버전별 호환성이 손상되는 변경 섹션에서 애플리케이션에서 사용하는 운전자 버전과 대상 업그레이드 버전 간의 호환성이 손상되는 변경을 해결하세요.

    예시

    운전자 를 v2.14 에서 v2.21 로 업그레이드하는 경우 v2.14 이후 버전의 모든 호환성이 손상되는 변경을 주소 합니다. (v2.19), v2.21 에 대한 모든 변경 사항을 포함합니다.

버전별 단절적 변경 사항

다음 섹션에서는 각 운전자 버전으로 인해 발생할 수 있는 잠재적인 호환성이 손상되는 변경에 대해 설명합니다. 이 섹션에 운전자 버전이 포함되어 있지 않은 경우 호환성이 손상되는 변경이 발생하지 않습니다.

버전 2.28.0 호환성이 손상되는 변경

  • 운전자 는 모든 운전자 구성 요소에 강력한 이름을 사용합니다. 애플리케이션 에 여러 .NET/ C# 드라이버 버전을 참조하는 종속성이 있는 경우 다음 예시 와 같이 바인딩 리디렉션을 만들어야 합니다.

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

버전 2.21.0 호환성이 손상되는 변경

  • 운전자 는 Atlas Search 빌더 에서 Render 메서드의 서명을 변경합니다. 이전 운전자 버전에서는 이러한 메서드에 다음과 같은 서명이 있었습니다.

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

    버전 2.21.0 이상에서는 Render 메서드에 다음과 같은 서명이 있습니다.

    Render(SearchDefinitionRenderContext<TDocument> renderContext);

버전 2.19.0 호환성이 손상되는 변경

  • ObjectSerializer는 안전하다고 간주되는 유형의 역직렬화만 허용합니다. 달리 지정하지 않으면 ObjectSerializer는 ObjectSerializer.DefaultAllowedTypes에서 반환된 유형을 사용합니다.

    에 학습 ObjectSerializer 보려면 FAQ 를 참조하세요. 에 대한 DefaultAllowedTypes 자세한 내용은 API 설명서를 참조하세요.

  • 기본 LinqProvider는 LINQ3로 변경되었습니다. 다음 코드 예시와 같이 MongoClientSettings에서 LINQ2에 대해 LinqProvider를 구성할 수 있습니다.

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

버전 2.14.0 호환성이 손상되는 변경

  • 운전자 는 MongoDB Server v3.4 및 이전 버전에 대한 지원 을 중단합니다. MongoDB Server 를 v3.6 이상으로 업그레이드 해야 합니다.

    MongoDB Server 배포서버 서버를 업그레이드 하는 방법을 학습 보려면 MongoDB Server 매뉴얼의 릴리스 노트 를 참조하세요. .NET/ C# 드라이버 와 MongoDB Server 간의 호환성에 학습 보려면 호환성 페이지를 참조하세요.

  • 운전자 는 .NET 프레임워크 v4.5.2 및 이전 버전에 대한 지원 을 중단합니다. 애플리케이션 은 .NET 프레임워크 v4.7.2 이상, .NET Core 2.x 이상 또는 .NET 5 이상을 사용해야 합니다.

    .NET/ C# 드라이버 와 .NET 간의 호환성에 학습 보려면 호환성 페이지를 참조하세요.

  • 운전자 는 .NET Standard v1.5에 대한 지원 을 중단합니다. 애플리케이션 은 .NET Standard v2.0 이상을 사용해야 합니다.

돌아가기

업그레이드

다음

버전 3.0