ObjectCache.Host Property

Definition

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Package:

System.Runtime.Caching v9.0.0-rc.2.24473.5

Gets or sets a reference to a managed hosting environment that is available to ObjectCache implementations and that can provide host-specific services to ObjectCache implementations.

public:
 static property IServiceProvider ^ Host { IServiceProvider ^ get(); void set(IServiceProvider ^ value); };

public static IServiceProvider Host { get; set; }

static member Host : IServiceProvider with get, set

Public Shared Property Host As IServiceProvider

Property Value

IServiceProvider

A reference to a cache-aware managed hosting environment.

Exceptions

ArgumentNullException

The value being assigned to the property is null.

InvalidOperationException

An attempt was made to set the property value more than one time.

Remarks

The Host property is intended for use by .NET Framework host environments and by cache implementations that implement behavior that depends on the .NET Framework host environment.

The following table lists the set of host environment services that might be available from a managed hosting environment and that are available to ObjectCache implementations through the Host property:

Service	Description
IApplicationIdentifier	Lets host environments provide application domain identifiers that might be needed by a cache implementation for features such as identifying performance counters.
IFileChangeNotificationSystem	Lets host environments provide a custom file-change notification system, instead of using the one provided in the .NET Framework.
IMemoryCacheManager	Lets cache implementations report cache memory consumption to the host environment. This enables host environments to centrally manage memory consumption across multiple cache implementations.

Note

Callers of this property value require unrestricted code access security permissions.