ObjectCache.Host Property

.NET Framework (current version)
 

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

Namespace:   System.Runtime.Caching
Assembly:  System.Runtime.Caching (in System.Runtime.Caching.dll)

public static IServiceProvider Host {
	[SecurityCriticalAttribute]
	[PermissionSetAttribute(SecurityAction.Demand, Unrestricted = true)]
	get;
	[SecurityCriticalAttribute]
	[PermissionSetAttribute(SecurityAction.Demand, Unrestricted = true)]
	set;
}

Property Value

Type: System.IServiceProvider

A reference to a cache-aware managed hosting environment.

Exception Condition
ArgumentNullException

The value being assigned to the property is null.

InvalidOperationException

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

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.

System_CAPS_noteNote

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

Demand

for full trust for all accessors of this property. This property cannot be used by partially trusted code.

.NET Framework
Available since 4.0
Return to top
Show: