附属程序集加载算法

使用附属程序集来存储为语言和区域性自定义的本地化资源。

附属程序集使用不同于常规托管程序集的加载算法。

何时加载附属程序集?

加载本地化资源时加载附属程序集。

加载本地化资源的基本 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。 此值指示资源的最终回退位置是附属程序集,而不是主程序集。

    注意

    默认区域性为最终回退。 因此,建议在默认资源文件中始终包含一组详尽的资源。 这有助于防止引发异常。 通过拥有详尽资源集,可为所有资源提供回退,并确保始终向用户呈现至少一种资源,即使该资源不是特定于区域性的。

  6. 最后,