All pages
Powered by GitBook
1 of 4

General

InjectAttribute

Wisej.Services.InjectAttribute

Namespace: Wisej.Services

Assembly: Wisej.Framework (3.1.0.0)

Indicates that the associated property references a service injected by the service provider during initialization.

public class InjectAttribute : Attribute
Public Class InjectAttribute
    Inherits Attribute

Use this attribute on properties (can be private, protected, or public) that represent an injected service instance.


public class MainView : Page {

  [Inject(Required=true)]
  protected ILogger Logger {get; set;}
}

Dependency injection is applied automatically for all top level containers: Form, Page, Desktop; and for all service instances created by the system. You can also inject dependencies into other objects by calling Application.Services.Inject after creating the target object.

Constructors

InjectAttribute()

Initializes a new instance of the InjectAttribute class.

InjectAttribute(required)

Initializes a new instance of the InjectAttribute class.

Name
Type
Description

required

Boolean

True to indicated that the service is required.

Properties

Required

Boolean: Indicates that the service is required.

ServiceLifetime

Wisej.Services.ServiceLifetime

Namespace: Wisej.Services

Assembly: Wisej.Framework (3.1.0.0)

Specifies the lifetime of a service.

public enum ServiceLifetime : Enum
Public Enum ServiceLifetime As [Enum]

Fields

Name
Description

Session

A new instance of the service is created and cached for the current session; it will be automatically disposed, if it implements an IDisposable, at the end of the session.

Shared

A single static instance of the service is available to all sessions.

Thread

A new instance of the service is created for each new thread; it will be automatically disposed, if it implements an IDisposable, at the end of the request.

Transient

A new instance of the service is created every time it's requested. The consumer is responsible for disposing it.

Used By

Name
Description

ServiceProvider.AddService

Registers a scoped service.

ServiceProvider

Wisej.Services.ServiceProvider

Namespace: Wisej.Services

Assembly: Wisej.Framework (3.1.0.0)

Manages services for Wisej.NET's DI implementation.

public class ServiceProvider : IServiceProvider
Public Class ServiceProvider
    Inherits IServiceProvider

Methods

AddService<TService>(lifetime)

Registers a scoped service.

Parameter
Type
Description

TService

The service to add.

lifetime

ServiceLifetime

Scope of the service. Default is Shared.

Throws:

AddService<TService, TImplementation>(lifetime)

Registers a scoped service.

Parameter
Type
Description

TService

The type of the service to add.

TImplementation

The type of the implementation to use.

lifetime

ServiceLifetime

Scope of the service. Default is Shared.

Throws:

AddService<TService>(implementationTypeName, lifetime)

Registers a scoped service.

Parameter
Type
Description

TService

The type of the service to add.

implementationTypeName

String

The name of the type of the implementation; can be a fully qualified assembly + type name.

lifetime

ServiceLifetime

Scope of the service. Default is Shared.

Using this overload allows the application to register a service implementation that is loaded dynamically when requested. If implementationTypeName is a fully qualified type name, including the assembly name, the assembly and type are loaded on demand. Throws:

AddService<TService>(serviceImplementation, lifetime)

Registers a scoped service.

Parameter
Type
Description

TService

The service to add.

serviceImplementation

Object

Implementation for the TService .

lifetime

ServiceLifetime

Scope of the service. Default is Shared.

Throws:

AddService<TService>(implementationFactory, lifetime)

Registers a scoped service.

Parameter
Type
Description

TService

The type of the service to add.

implementationFactory

Func<Type, Object>

Method for creating the TService instance.

lifetime

ServiceLifetime

Scope of the service. Default is Shared.

Throws:

GetService<T>()

Returns the requested service.

Parameter
Type
Description

T

Type of the service to retrieve.

Returns: T. An instance of T or null if the service is not found.

GetService(serviceType)

Returns the requested service.

Parameter
Type
Description

serviceType

Type

Type of the service to add.

Returns: Object. An instance of serviceType or null if the service is not found.

Throws:

Inject(target)

Injects the services into the properties marked with the InjectAttribute attributed on the specified target object.

Parameter
Type
Description

target

Object

Target object to inject dependencies into.

Throws:

RemoveService(serviceType)

Removes the specified service type from the service container.

Parameter
Type
Description

serviceType

Type

Type of the service to remove.

Throws: