VContainer-resolving/container-api | 解析——容器 API

合集 - VContainer 中文文档(33)

1.VContainer 介绍02-172.VContainer-about/what-is-vcontainer | 概述——VContainer 是什么？02-173.VContainer-about/what-is-di | 概述——DI 是什么？02-174.VContainer-getting-started/installation | 入门——安装02-175.VContainer-getting-started/hello-world | 入门——Hello World02-176.VContainer-resolving/constructor-injection | 解析——构造函数注入02-177.VContainer-resolving/method-injection | 解析——方法注入02-178.VContainer-resolving/property-field-injection | 解析——属性/字段注入02-179.VContainer-resolving/gameobject-injection | 解析——注入到 MonoBehaviours 中02-17

10.VContainer-resolving/container-api | 解析——容器 API02-17

11.VContainer-registering/register-type | 注册——注册纯 C# 类型02-1712.VContainer-registering/register-using-delegate | 注册——注册使用委托02-1713.VContainer-registering/register-factory | 注册——注册工厂02-1714.VContainer-registering/register-monobehaviour | 注册——注册 MonoBehaviour02-1715.VContainer-registering/register-scriptable-object | 注册——注册 ScriptableObject02-1716.VContainer-registering/register-collection | 注册——注册集合02-1717.VContainer-registering/register-callbacks | 注册——注册回调02-1718.VContainer-integrations/entrypoint | 集成——纯 C# 入口点02-1719.VContainer-integrations/unitask | 集成——Unitask02-1820.VContainer-integrations/unirx | 集成——UniRx02-1821.VContainer-integrations/messagepipe | 集成——MessagePipe02-1822.VContainer-integrations/ecs | 集成——ECS (beta)02-1823.VContainer-scoping/lifetime-overview | 作用域——生命周期管理总览02-1824.VContainer-scoping/generate-child-via-scene | 作用域——通过场景或 prefab 生成子作用域02-1825.VContainer-scoping/generate-child-with-code-first | 作用域——通过代码优先生成子作用域02-1826.VContainer-scoping/project-root-lifetimescope | 作用域——项目根作用域 LifetimeScope02-1827.VContainer-diagnostics/diagnostics-window | 诊断——VContainer 诊断窗口02-1828.VContainer-optimization/source-generator | 优化——源码生成器02-1829.**VContainer-optimization/async-container-build | 优化——异步容器构建02-1830.VContainer-optimization/parallel-container-build | 优化——并行容器构建02-1831.VContainer-optimization/codegen | 优化——预生成 IL 代码（已弃用）02-1832.VContainer-comparing/comparing-to-zenject | 对比 Zenject02-1833.MessagePipe 中文文档02-20

收起

通过 IObjectResolver 可以直接访问 DI 容器。VContainer 会自动注册 IObjectResolver 并将其注入到任何需要的地方，因此你可以通过依赖注入获取实例：

例如：

class ClassA
{
    public ClassA(IObjectResolver container)
    {
        // 解析已注册的ServiceA实例。
        // 如果将子类注册为 ServiceA，这可能是子类。
        var serviceA = container.Resolve<ServiceA>();

        // 对foo对象执行依赖注入。
        // 重复注入同一个对象会覆盖已标记为 [Inject] 的属性或字段（或调用方法）。
        container.Inject(foo);

        // 注入到整个 GameObject 及其子物体的 MonoBehaviour 中,
        // 无论目标 GameObject 和 MonoBehaviours 是否已启用。
        container.InjectGameObject(gameObject);

        // 实例化预制体并自动注入依赖，
        // 依赖项将注入其 MonoBehaviours（及其子对象的 MonoBehaviours）中。
        // 通过其他方式创建 GameObject（例如程序化生成或从 Addressables 加载），请考虑使用 InjectGameObject。
        var object1 = container.Instantiate(prefab);

        // 支持多种实例化重载
        var object2 = container.Instantiate(prefab, parent);
        var object3 = container.Instantiate(prefab, position, rotation, parent);
    }
}

如果经常以某种模式使用 IObjectResolver.Inject，建议封装为扩展方法。事实上，几乎每个 IObjectResolver API 都是一个扩展方法（包括前面的代码示例）。

:::tip
建议优先使用自动注入而非显式调用 Resolve。只有在其他支持的注入技术不符合你的需求时，或者在使用暴露了 IObjectResolver 的 VContainer 回调时（例如 构建回调 或 某些工厂函数），你才需要显式使用 IObjectResolver.Resolve。所有解析技术在性能上相似（如果你使用了 IL 生成器），但直接使用 Resolve 需要编写更多代码并且会模糊你的意图。
:::

LifetimeScope 通过其 Container 属性引用 IObjectResolver。VContainer 也会自动注册它，但在容器构建后通常不再需要它。通过 LifetimeScope 的 Container 属性也可访问解析器：

class ClassA
{
    public ClassA(LifetimeScope currentScope)
    {
        // 如果需要，也可以注入 LifetimeScope，
        // 但在这种情况下自动注入 ServiceA 足矣。
        var foo = currentScope.Container.Resolve<ServiceA>();
    }
}