Bind Services

Using the [BindService] attribute allows the developer to establish dependencies with a Service registered in the Application Container.

// Bind the Graphics Context registered in the Application...
[BindService]
private GraphicsContext transform;

Note

[BindService] can be used inside Services, Components, and SceneManagers. Otherwise, the binding cannot be resolved.

[BindService] Properties

This attribute offers several ways to customize:

isRequired (default true)

If the value is true, the dependency is required to be resolved; otherwise, the current Component won't be attached.

The isRequired value has the same functionality as [BindComponent] (see Bind Components for further details).

For example, if these are all the Services registered inside the Application Container:

// Register services in the application container...
this.Container.RegisterType<TimerFactory>();
this.Container.RegisterType<Random>();
this.Container.RegisterType<ErrorHandler>();
this.Container.RegisterType<ScreenContextManager>();
this.Container.RegisterType<GraphicsPresenter>();
this.Container.RegisterType<AssetsDirectory>();
this.Container.RegisterType<AssetsService>();
this.Container.RegisterType<ForegroundTaskSchedulerService>();            
this.Container.RegisterType<WorkActionScheduler>();

The following component will be attached because the AssetsService has been registered:

public class MyComponent : Component
{
    [BindService]
    private AssetsService assetService;

    // ...
}

However, in this case, the dependency will fail because the Clock service is not registered:

public class MyComponent : Component
{
    [BindService]
    private Clock clock;

    // ...
}