다음을 통해 공유

위성 어셈블리 로드 알고리즘

  • 아티클

위성 어셈블리는 언어 및 문화권에 맞게 사용자 지정된 지역화된 리소스를 저장하는 데 사용됩니다.

위성 어셈블리는 일반적인 관리 어셈블리와 다른 로드 알고리즘을 사용합니다.

위성 어셈블리는 언제 로드되나요?

위성 어셈블리는 지역화된 리소스를 로드할 때 로드됩니다.

지역화된 리소스를 로드하는 기본 API는 System.Resources.ResourceManager 클래스입니다. 궁극적으로 ResourceManager 클래스는 각 CultureInfo.Name에 대해 GetSatelliteAssembly 메서드를 호출합니다.

상위 수준 API는 하위 수준 API를 추상화할 수 있습니다.

알고리즘

.NET Core 리소스 대체 프로세스에는 다음 단계가 포함됩니다.

  1. active AssemblyLoadContext 인스턴스를 확인합니다. 모든 경우에 active 인스턴스는 실행 중인 어셈블리의 AssemblyLoadContext입니다.

  2. active 인스턴스는 다음 우선 순위에 따라 요청된 문화권에 대한 위성 어셈블리를 로드합니다.

  3. 위성 어셈블리가 로드된 경우:

    • AppDomain.AssemblyLoad 이벤트가 발생합니다.
    • 어셈블리에서 요청된 리소스를 검색합니다. 런타임이 어셈블리에서 리소스를 찾으면 해당 리소스가 사용됩니다. 리소스를 찾지 못하면 검색을 계속합니다.

    참고 항목

    위성 어셈블리 내의 리소스를 찾기 위해 런타임은 ResourceManager에서 현재 CultureInfo.Name에 대해 요청한 리소스 파일을 검색합니다. 리소스 파일 내에서 요청된 리소스 이름을 검색합니다. 둘 중 하나라도 찾지 못하면 리소스가 찾을 수 없는 것으로 처리됩니다.

  4. ResourceManager는 다음에 여러 잠재적인 수준에서 부모 문화권 어셈블리를 검색하며 매번 2-3단계를 반복합니다.

    각 문화권에는 CultureInfo.Parent 속성으로 정의되는 하나의 부모만 있습니다.

    문화권의 Parent 속성이 CultureInfo.InvariantCulture이면 부모 문화권 검색이 중지됩니다.

    InvariantCulture의 경우 2-3 단계로 돌아가지 않고 5단계로 계속 진행합니다.

  5. 여전히 리소스를 찾을 수 없으면 ResourceManager는 기본(대체) 문화권에 대한 리소스를 사용합니다.

    일반적으로 기본 문화권의 리소스는 주 애플리케이션 어셈블리에 포함되어 있습니다. 그러나 NeutralResourcesLanguageAttribute.Location 속성에 대해 UltimateResourceFallbackLocation.Satellite을 지정할 수 있습니다. 이 값은 리소스의 최종 대체 위치가 주 어셈블리가 아닌 위성 어셈블리임을 나타냅니다.

    참고 항목

    기본 문화권이 최종 대체(fallback)입니다. 따라서 기본 리소스 파일에 완전한 리소스 세트를 항상 포함하는 것이 좋습니다. 이렇게 하면 예외가 throw되지 않도록 방지하는 데 도움이 됩니다. 전체 집합을 통해 모든 리소스에 대한 대체를 제공하고 사용자에게 항상 리소스가 하나 이상 제공되도록 합니다.

  6. 마지막으로