Loyc.Threading.AmbientService< T > Class Template Reference

Holds the shared state behind an ambient service (the Ambient Service Pattern): a global default instance, plus an async-local override installed by Set in a using statement. More...

---

Source file:

• /Core/Loyc.Essentials/Utilities/AmbientService.cs

Inheritance diagram for Loyc.Threading.AmbientService< T >:

Remarks

Holds the shared state behind an ambient service (the Ambient Service Pattern): a global default instance, plus an async-local override installed by Set in a using statement.

This is based on AsyncLocal, which is reportedly slow, so Value doesn't touch it while no override exists anywhere.

Because the override is an AsyncLocal rather than a ThreadLocal, it flows across await points to continuations, even when they resume on a different thread.

Nested classes
struct	Saved
	Returned by Set; restores the previous ambient override (if any) when disposed. More...

Properties
T	GlobalDefault [get, set]
	The instance used by every execution context that has no ambient override from Set. It can be replaced app-wide. More...
T	Value [get]
	Gets the current T instance (the current async execution context's override if one is active, otherwise GlobalDefault. More...

Public Member Functions
	AmbientService (T globalDefault)
Saved	Set (T newValue, bool alsoSetGlobalDefault=false)
	Installs an ambient (async-local) override. Designed to be used in a using statement, which restores the old value at the end. If requested, changes GlobalDefault too. More...

Member Function Documentation

Saved Loyc.Threading.AmbientService< T >.Set ( T  newValue, bool  alsoSetGlobalDefault = false  )

inline

Installs an ambient (async-local) override. Designed to be used in a using statement, which restores the old value at the end. If requested, changes GlobalDefault too.

An override installed inside an async method does not propagate up to its caller's context, so call Set in the same method as the using block that scopes it.

Property Documentation

T Loyc.Threading.AmbientService< T >.GlobalDefault

getset

The instance used by every execution context that has no ambient override from Set. It can be replaced app-wide.

T Loyc.Threading.AmbientService< T >.Value

get

Gets the current T instance (the current async execution context's override if one is active, otherwise GlobalDefault.