Class AmbientServices

Provides the global ambient services.

Inheritance
System.Object
System.Dynamic.DynamicObject
ExpandoBase
Expando
AmbientServices
Implements
System.Dynamic.IDynamicMetaObjectProvider
System.IServiceProvider
Inherited Members
System.Dynamic.DynamicObject.GetMetaObject(System.Linq.Expressions.Expression)
System.Dynamic.DynamicObject.TryBinaryOperation(System.Dynamic.BinaryOperationBinder, System.Object, System.Object)
System.Dynamic.DynamicObject.TryConvert(System.Dynamic.ConvertBinder, System.Object)
System.Dynamic.DynamicObject.TryCreateInstance(System.Dynamic.CreateInstanceBinder, System.Object[], System.Object)
System.Dynamic.DynamicObject.TryDeleteIndex(System.Dynamic.DeleteIndexBinder, System.Object[])
System.Dynamic.DynamicObject.TryDeleteMember(System.Dynamic.DeleteMemberBinder)
System.Dynamic.DynamicObject.TryGetIndex(System.Dynamic.GetIndexBinder, System.Object[], System.Object)
System.Dynamic.DynamicObject.TryInvoke(System.Dynamic.InvokeBinder, System.Object[], System.Object)
System.Dynamic.DynamicObject.TrySetIndex(System.Dynamic.SetIndexBinder, System.Object[], System.Object)
System.Dynamic.DynamicObject.TryUnaryOperation(System.Dynamic.UnaryOperationBinder, System.Object)
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Kephas
Assembly: Kephas.Core.dll
Syntax
public class AmbientServices : Expando, IAmbientServices, IExpando, IDynamicMetaObjectProvider, IIndexable, IServiceProvider, IAppServiceInfoProvider
Remarks

It is a recommended practice to not use global services, instead get the services using the composition (the classical example is the unit testing, where the classes should be sandboxed as much as possible). However, there may be cases when this cannot be avoided, such as static classes or classes which get instantiated outside of the developer's control (like in the case of the entities instatiated by the ORMs). Those are cases where the AmbientServices can be safely used.

Constructors

| Improve this Doc View Source

AmbientServices(Boolean)

Initializes a new instance of the AmbientServices class.

Declaration
public AmbientServices(bool registerDefaultServices = true)
Parameters
Type Name Description
System.Boolean registerDefaultServices

Optional. True to register default services.

Properties

| Improve this Doc View Source

AppRuntime

Gets the application runtime.

Declaration
public IAppRuntime AppRuntime { get; }
Property Value
Type Description
IAppRuntime

The application runtime.
| Improve this Doc View Source

AssemblyLoader

Gets the assembly loader.

Declaration
public IAssemblyLoader AssemblyLoader { get; }
Property Value
Type Description
IAssemblyLoader

The assembly loader.
| Improve this Doc View Source

CompositionContainer

Gets the composition container.

Declaration
public ICompositionContext CompositionContainer { get; }
Property Value
Type Description
ICompositionContext

The composition container.
| Improve this Doc View Source

ConfigurationStore

Gets the configuration store.

Declaration
public IConfigurationStore ConfigurationStore { get; }
Property Value
Type Description
IConfigurationStore

The configuration store.
| Improve this Doc View Source

Instance

Gets or sets the static instance of the ambient services.

Declaration
public static IAmbientServices Instance { get; set; }
Property Value
Type Description
IAmbientServices

The instance.
Remarks

Setting the globally available instance must be executed before getting its value for the first time, otherwise it will be initialized with the default instance.

| Improve this Doc View Source

LogManager

Gets the log manager.

Declaration
public ILogManager LogManager { get; }
Property Value
Type Description
ILogManager

The log manager.

Methods

| Improve this Doc View Source

GetAppServiceInfos(IList<Type>, ICompositionRegistrationContext)

Gets the application service infos in this collection.

Declaration
public IEnumerable<(Type contractType, IAppServiceInfo appServiceInfo)> GetAppServiceInfos(IList<Type> candidateTypes, ICompositionRegistrationContext registrationContext)
Parameters
Type Name Description
System.Collections.Generic.IList<System.Type> candidateTypes

List of types of the candidates.
ICompositionRegistrationContext registrationContext

Context for the registration.
Returns
Type Description
System.Collections.Generic.IEnumerable<System.ValueTuple<System.Type, IAppServiceInfo>>

An enumerator that allows foreach to be used to process the application service infos in this collection.
| Improve this Doc View Source

GetService(Type)

Gets the service object of the specified type.

Declaration
public object GetService(Type serviceType)
Parameters
Type Name Description
System.Type serviceType

An object that specifies the type of service object to get.

Returns
Type Description
System.Object

A service object of type serviceType.-or- null if there is no service object of type serviceType.
| Improve this Doc View Source

IsRegistered(Type)

Gets a value indicating whether the service with the provided contract is registered.

Declaration
public bool IsRegistered(Type serviceType)
Parameters
Type Name Description
System.Type serviceType

Type of the service.
Returns
Type Description
System.Boolean

true if the service is registered, false if not.
| Improve this Doc View Source

Register(Type, Action<IServiceRegistrationBuilder>)

Registers the provided service using a registration builder.

Declaration
public virtual IAmbientServices Register(Type serviceType, Action<IServiceRegistrationBuilder> builder)
Parameters
Type Name Description
System.Type serviceType

Type of the service.
System.Action<IServiceRegistrationBuilder> builder

The builder.
Returns
Type Description
IAmbientServices

The IAmbientServices.

Implements

System.Dynamic.IDynamicMetaObjectProvider
System.IServiceProvider

Extension Methods