• CacheManager
  • Documentation
  • Api Docs
  • MichaCo.net
    Show / Hide Table of Contents

    Class ConfigurationBuilder

    Helper class to load cache manager configurations from file or to build new configurations in a fluent way.

    This only loads configurations. To build a cache manager instance, use CacheFactory and pass in the configuration. Or use the Build methods of CacheFactory!

    Inheritance
    Object
    ConfigurationBuilderCachePart
    ConfigurationBuilder
    Inherited Members
    ConfigurationBuilderCachePart.WithBackplane(Type, String, Object[])
    ConfigurationBuilderCachePart.WithBackplane(Type, String, String, Object[])
    ConfigurationBuilderCachePart.WithDictionaryHandle(Boolean)
    ConfigurationBuilderCachePart.WithDictionaryHandle(String, Boolean)
    ConfigurationBuilderCachePart.WithHandle(Type, String, Boolean, Object[])
    ConfigurationBuilderCachePart.WithHandle(Type, String)
    ConfigurationBuilderCachePart.WithHandle(Type)
    ConfigurationBuilderCachePart.WithMaxRetries(Int32)
    ConfigurationBuilderCachePart.WithRetryTimeout(Int32)
    ConfigurationBuilderCachePart.WithUpdateMode(CacheUpdateMode)
    ConfigurationBuilderCachePart.WithSerializer(Type, Object[])
    ConfigurationBuilderCachePart.WithBinarySerializer()
    ConfigurationBuilderCachePart.WithBinarySerializer(BinaryFormatter, BinaryFormatter)
    ConfigurationBuilderCachePart.WithLogging(Type, Object[])
    ConfigurationBuilderCachePart.Build()
    Object.ToString()
    Object.Equals(Object)
    Object.Equals(Object, Object)
    Object.ReferenceEquals(Object, Object)
    Object.GetHashCode()
    Object.GetType()
    Object.MemberwiseClone()
    Namespace:CacheManager.Core
    Assembly:CacheManager.Core.dll
    Syntax
    public class ConfigurationBuilder : ConfigurationBuilderCachePart

    Constructors

    | Improve this Doc View Source

    ConfigurationBuilder()

    Initializes a new instance of the ConfigurationBuilder class which provides fluent configuration methods.

    Declaration
    public ConfigurationBuilder()
    | Improve this Doc View Source

    ConfigurationBuilder(ICacheManagerConfiguration)

    Initializes a new instance of the ConfigurationBuilder class which provides fluent configuration methods. Creates a builder which allows to modify the existing forConfiguration.

    Declaration
    public ConfigurationBuilder(ICacheManagerConfiguration forConfiguration)
    Parameters
    Type Name Description
    ICacheManagerConfiguration forConfiguration

    The configuration the builder should be instantiated for.

    | Improve this Doc View Source

    ConfigurationBuilder(String)

    Initializes a new instance of the ConfigurationBuilder class which provides fluent configuration methods.

    Declaration
    public ConfigurationBuilder(string name)
    Parameters
    Type Name Description
    String name

    The name of the cache manager.

    | Improve this Doc View Source

    ConfigurationBuilder(String, ICacheManagerConfiguration)

    Initializes a new instance of the ConfigurationBuilder class which provides fluent configuration methods. Creates a builder which allows to modify the existing forConfiguration.

    Declaration
    public ConfigurationBuilder(string name, ICacheManagerConfiguration forConfiguration)
    Parameters
    Type Name Description
    String name

    The name of the cache manager.

    ICacheManagerConfiguration forConfiguration

    The configuration the builder should be instantiated for.

    Methods

    | Improve this Doc View Source

    BuildConfiguration(Action<ConfigurationBuilderCachePart>)

    Builds a CacheManagerConfiguration which can be used to create a new cache manager instance.

    Pass the configuration to FromConfiguration<TCacheValue>(ICacheManagerConfiguration) to create a valid cache manager.

    Declaration
    public static ICacheManagerConfiguration BuildConfiguration(Action<ConfigurationBuilderCachePart> settings)
    Parameters
    Type Name Description
    Action<ConfigurationBuilderCachePart> settings

    The configuration settings to define the cache handles and other properties.

    Returns
    Type Description
    ICacheManagerConfiguration

    The ICacheManagerConfiguration.

    | Improve this Doc View Source

    BuildConfiguration(String, Action<ConfigurationBuilderCachePart>)

    Builds a CacheManagerConfiguration which can be used to create a new cache manager instance.

    Pass the configuration to FromConfiguration<TCacheValue>(ICacheManagerConfiguration) to create a valid cache manager.

    Declaration
    public static ICacheManagerConfiguration BuildConfiguration(string name, Action<ConfigurationBuilderCachePart> settings)
    Parameters
    Type Name Description
    String name

    The name of the cache manager.

    Action<ConfigurationBuilderCachePart> settings

    The configuration settings to define the cache handles and other properties.

    Returns
    Type Description
    ICacheManagerConfiguration

    The ICacheManagerConfiguration.

    | Improve this Doc View Source

    LoadConfiguration(String)

    Loads a configuration from web.config or app.config.

    The configName must match with the name attribute of one of the configured cache elements.

    Declaration
    public static ICacheManagerConfiguration LoadConfiguration(string configName)
    Parameters
    Type Name Description
    String configName

    The name of the cache element within the config file.

    Returns
    Type Description
    ICacheManagerConfiguration

    The CacheManagerConfiguration

    | Improve this Doc View Source

    LoadConfiguration(String, String)

    Loads a configuration from web.config or app.config, by section and config name.

    The configName must match with the name attribute of one of the configured cache elements.

    Declaration
    public static ICacheManagerConfiguration LoadConfiguration(string sectionName, string configName)
    Parameters
    Type Name Description
    String sectionName

    The name of the section.

    String configName

    The name of the cache element within the config file.

    Returns
    Type Description
    ICacheManagerConfiguration

    The CacheManagerConfiguration

    | Improve this Doc View Source

    LoadConfigurationFile(String, String)

    Loads a configuration from the given configFileName.

    The configName must match with the name attribute of one of the configured cache elements.

    Declaration
    public static ICacheManagerConfiguration LoadConfigurationFile(string configFileName, string configName)
    Parameters
    Type Name Description
    String configFileName

    The full path of the file to load the configuration from.

    String configName

    The name of the cache element within the config file.

    Returns
    Type Description
    ICacheManagerConfiguration

    The CacheManagerConfiguration

    Exceptions
    Type Condition
    ArgumentNullException

    If configFileName or configName are null.

    InvalidOperationException

    If the file specified by configFileName does not exist.

    | Improve this Doc View Source

    LoadConfigurationFile(String, String, String)

    Loads a configuration from the given configFileName and sectionName.

    The configName must match with the name attribute of one of the configured cache elements.

    Declaration
    public static ICacheManagerConfiguration LoadConfigurationFile(string configFileName, string sectionName, string configName)
    Parameters
    Type Name Description
    String configFileName

    The full path of the file to load the configuration from.

    String sectionName

    The name of the configuration section.

    String configName

    The name of the cache element within the config file.

    Returns
    Type Description
    ICacheManagerConfiguration

    The CacheManagerConfiguration

    Exceptions
    Type Condition
    ArgumentNullException

    If configFileName or configName are null.

    InvalidOperationException

    If the file specified by configFileName does not exist.

    Extension Methods

    MicrosoftMemoryCachingBuilderExtensions.WithMicrosoftMemoryCacheHandle(ConfigurationBuilderCachePart, Boolean)
    MicrosoftMemoryCachingBuilderExtensions.WithMicrosoftMemoryCacheHandle(ConfigurationBuilderCachePart, String, Boolean)
    MicrosoftMemoryCachingBuilderExtensions.WithMicrosoftMemoryCacheHandle(ConfigurationBuilderCachePart, String, MemoryCacheOptions)
    MicrosoftMemoryCachingBuilderExtensions.WithMicrosoftMemoryCacheHandle(ConfigurationBuilderCachePart, MemoryCacheOptions)
    MicrosoftMemoryCachingBuilderExtensions.WithMicrosoftMemoryCacheHandle(ConfigurationBuilderCachePart, String, Boolean, MemoryCacheOptions)
    BondConfigurationBuilderExtensions.WithBondCompactBinarySerializer(ConfigurationBuilderCachePart, Int32)
    BondConfigurationBuilderExtensions.WithBondFastBinarySerializer(ConfigurationBuilderCachePart, Int32)
    BondConfigurationBuilderExtensions.WithBondSimpleJsonSerializer(ConfigurationBuilderCachePart)
    RedisConfigurationBuilderExtensions.WithRedisConfiguration(ConfigurationBuilderCachePart, String, Action<RedisConfigurationBuilder>)
    RedisConfigurationBuilderExtensions.WithRedisConfiguration(ConfigurationBuilderCachePart, String, String, Int32, Boolean)
    RedisConfigurationBuilderExtensions.WithRedisConfiguration(ConfigurationBuilderCachePart, String, IConnectionMultiplexer, Int32, Boolean)
    RedisConfigurationBuilderExtensions.WithRedisBackplane(ConfigurationBuilderCachePart, String)
    RedisConfigurationBuilderExtensions.WithRedisBackplane(ConfigurationBuilderCachePart, String, String)
    RedisConfigurationBuilderExtensions.WithRedisCacheHandle(ConfigurationBuilderCachePart, String, Boolean)
    MemcachedConfigurationBuilderExtensions.WithMemcachedCacheHandle(ConfigurationBuilderCachePart, String, Boolean)
    MemcachedConfigurationBuilderExtensions.WithMemcachedCacheHandle(ConfigurationBuilderCachePart, MemcachedClient, Boolean)
    MemcachedConfigurationBuilderExtensions.WithMemcachedCacheHandle(ConfigurationBuilderCachePart, String, MemcachedClient, Boolean)
    MemcachedConfigurationBuilderExtensions.WithMemcachedCacheHandle(ConfigurationBuilderCachePart, MemcachedClientConfiguration, Boolean)
    MemcachedConfigurationBuilderExtensions.WithMemcachedCacheHandle(ConfigurationBuilderCachePart, String, MemcachedClientConfiguration, Boolean)
    ProtoBufConfigurationBuilderExtensions.WithProtoBufSerializer(ConfigurationBuilderCachePart)
    JsonConfigurationBuilderExtensions.WithJsonSerializer(ConfigurationBuilderCachePart)
    JsonConfigurationBuilderExtensions.WithJsonSerializer(ConfigurationBuilderCachePart, JsonSerializerSettings, JsonSerializerSettings)
    JsonConfigurationBuilderExtensions.WithGzJsonSerializer(ConfigurationBuilderCachePart)
    JsonConfigurationBuilderExtensions.WithGzJsonSerializer(ConfigurationBuilderCachePart, JsonSerializerSettings, JsonSerializerSettings)
    RuntimeCachingBuilderExtensions.WithSystemRuntimeCacheHandle(ConfigurationBuilderCachePart, Boolean)
    RuntimeCachingBuilderExtensions.WithSystemRuntimeCacheHandle(ConfigurationBuilderCachePart, String, Boolean)
    CouchbaseConfigurationBuilderExtensions.WithCouchbaseConfiguration(ConfigurationBuilderCachePart, String, ClientConfiguration)
    CouchbaseConfigurationBuilderExtensions.WithCouchbaseConfiguration(ConfigurationBuilderCachePart, String, ICouchbaseClientDefinition)
    CouchbaseConfigurationBuilderExtensions.WithCouchbaseCluster(ConfigurationBuilderCachePart, String, ICluster)
    CouchbaseConfigurationBuilderExtensions.WithCouchbaseCacheHandle(ConfigurationBuilderCachePart, String, String, Boolean)
    CouchbaseConfigurationBuilderExtensions.WithCouchbaseCacheHandle(ConfigurationBuilderCachePart, String, String, String, Boolean)
    WebConfigurationBuilderExtensions.WithSystemWebCacheHandle(ConfigurationBuilderCachePart, Boolean)
    WebConfigurationBuilderExtensions.WithSystemWebCacheHandle(ConfigurationBuilderCachePart, String, Boolean)
    MicrosoftLoggingBuilderExtensions.WithMicrosoftLogging(ConfigurationBuilderCachePart, Action<ILoggerFactory>)
    MicrosoftLoggingBuilderExtensions.WithMicrosoftLogging(ConfigurationBuilderCachePart, ILoggerFactory)
    MicrosoftLoggingBuilderExtensions.WithMicrosoftLogging(ConfigurationBuilderCachePart, IServiceCollection)
    • Improve this Doc
    • View Source
    © 2025 by Michael Conrad. All rights reserved. - MichaCo.net