Use this type instead of ConcurrentDictionary<TKey, TValue> in caching scenarios.

Namespace

Interfaces

IConcurrentCache
IReadOnlyDictionary<TKey, TValue>
IReadOnlyCollection<KeyValuePair<TKey, TValue>>
IEnumerable<KeyValuePair<TKey, TValue>>
IEnumerable

Base Types

object

graph BT Type-->Base0["object"] Type-.->Interface0["IConcurrentCache"] click Interface0 "/api/Statiq.Common/IConcurrentCache" Type-.->Interface1["IReadOnlyDictionary<TKey, TValue>"] Type-.->Interface2["IReadOnlyCollection<KeyValuePair<TKey, TValue>>"] Type-.->Interface3["IEnumerable<KeyValuePair<TKey, TValue>>"] Type-.->Interface4["IEnumerable"] Type["ConcurrentCache<TKey, TValue>"] class Type type-node

Syntax

public class ConcurrentCache<TKey, TValue> : IConcurrentCache, IReadOnlyDictionary<TKey, TValue>, 
    IReadOnlyCollection<KeyValuePair<TKey, TValue>>, IEnumerable<KeyValuePair<TKey, TValue>>, 
    IEnumerable

Remarks

See http://reedcopsey.com/2011/01/16/concurrentdictionarytkeytvalue-used-with-lazyt/ and https://andrewlock.net/making-getoradd-on-concurrentdictionary-thread-safe-using-lazy/.

Type Parameters

Name	Description
TKey
TValue

Constructors

Name	Summary
ConcurrentCache(bool, bool, IEqualityComparer<TKey>)	Creates a thread-safe concurrent cache.
ConcurrentCache(bool, bool)	Creates a thread-safe concurrent cache.
ConcurrentCache(bool, IEqualityComparer<TKey>)	Creates a thread-safe concurrent cache.
ConcurrentCache(bool)	Creates a thread-safe concurrent cache.

Properties

Name	Property Type	Summary
Count	int
Keys	IEnumerable<TKey>
this[TKey]	TValue
Values	IEnumerable<TValue>

Methods

Name	Return Value	Summary
AddOrUpdate(TKey, Func<TKey, TValue>, Func<TKey, TValue, TValue>)	TValue
AddOrUpdate(TKey, TValue, Func<TKey, TValue, TValue>)	TValue
AddOrUpdate<TArg>(TKey, Func<TKey, TArg, TValue>, Func<TKey, TValue, TArg, TValue>, TArg)	TValue
ContainsKey(TKey)	bool
GetEnumerator()	IEnumerator<KeyValuePair<TKey, TValue>>
GetOrAdd(TKey, Func<TKey, TValue>)	TValue
GetOrAdd(TKey, TValue)	TValue
GetOrAdd<TArg>(TKey, Func<TKey, TArg, TValue>, TArg)	TValue
Reset()	void	Resets the cache by clearing all entries and disposing any `IDisposable` values.
TryAdd(TKey, Func<TValue>)	bool
TryAdd(TKey, TValue)	bool
TryGetValue(TKey, TValue)	bool
TryRemove(TKey, TValue)	bool

Extension Methods

Name	Value	Summary
Concat<KeyValuePair<TKey, TValue>>(KeyValuePair<TKey, TValue>)	IEnumerable<T>	From IEnumerableExtensions
ContainsAnyKeys<TKey, TValue>(IEnumerable<TKey>)	bool	Determines whether the dictionary contains all the specified keys. From IReadOnlyDictionaryExtensions
ContainsAnyKeys<TKey, TValue>(TKey[])	bool	Determines whether the dictionary contains all the specified keys. From IReadOnlyDictionaryExtensions
ContainsKeys<TKey, TValue>(IEnumerable<TKey>)	bool	Determines whether the dictionary contains all the specified keys. From IReadOnlyDictionaryExtensions
ContainsKeys<TKey, TValue>(TKey[])	bool	Determines whether the dictionary contains all the specified keys. From IReadOnlyDictionaryExtensions
GetNext<KeyValuePair<TKey, TValue>>(KeyValuePair<TKey, TValue>, IEqualityComparer<KeyValuePair<TKey, TValue>>)	T	From IEnumerableExtensions
GetNext<KeyValuePair<TKey, TValue>>(KeyValuePair<TKey, TValue>)	T	From IEnumerableExtensions
GetPrevious<KeyValuePair<TKey, TValue>>(KeyValuePair<TKey, TValue>, IEqualityComparer<KeyValuePair<TKey, TValue>>)	T	From IEnumerableExtensions
GetPrevious<KeyValuePair<TKey, TValue>>(KeyValuePair<TKey, TValue>)	T	From IEnumerableExtensions
GroupByMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, TElement>, IEqualityComparer<TKey>)	IEnumerable<IGrouping<TKey, TElement>>	Groups the elements of a sequence according to a specified key selector function that returns a sequence of keys. The keys are compared by using a comparer and each group's elements are projected by using a specified function. From GroupByExtensions
GroupByMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, TElement>)	IEnumerable<IGrouping<TKey, TElement>>	Groups the elements of a sequence according to a specified key selector function that returns a sequence of keys and projects the elements for each group by using a specified function. From GroupByExtensions
GroupByMany<KeyValuePair<TKey, TValue>, TKey>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, IEqualityComparer<TKey>)	IEnumerable<IGrouping<TKey, TSource>>	Groups the elements of a sequence according to a specified key selector function that returns a sequence of keys and compares the keys by using a specified comparer. From GroupByExtensions
GroupByMany<KeyValuePair<TKey, TValue>, TKey>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>)	IEnumerable<IGrouping<TKey, TSource>>	Groups the elements of a sequence according to a specified key selector function that returns a sequence of keys. From GroupByExtensions
GroupByManyToMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, IEnumerable<TElement>>, IEqualityComparer<TKey>)	IEnumerable<IGrouping<TKey, TElement>>	Groups the elements of a sequence according to a specified key selector function that returns a sequence of keys. The keys are compared by using a comparer and each group's elements are projected by using a specified function that returns a sequence of elements. From GroupByExtensions
GroupByManyToMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, IEnumerable<TElement>>)	IEnumerable<IGrouping<TKey, TElement>>	Groups the elements of a sequence according to a specified key selector function that returns a sequence of keys and projects the elements for each group by using a specified function that returns a sequence of elements. From GroupByExtensions
ParallelForEachAsync<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, Task>, CancellationToken)	Task	From ParallelAsyncExtensions
ParallelSelectAsync<KeyValuePair<TKey, TValue>, TResult>(Func<KeyValuePair<TKey, TValue>, Task<TResult>>, CancellationToken)	Task<IEnumerable<TResult>>	Invokes an async selector in parallel. From ParallelAsyncExtensions
ParallelSelectManyAsync<KeyValuePair<TKey, TValue>, TResult>(Func<KeyValuePair<TKey, TValue>, Task<IEnumerable<TResult>>>, CancellationToken)	Task<IEnumerable<TResult>>	Invokes an async selector that returns multiple results in parallel. From ParallelAsyncExtensions
ParallelWhereAsync<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, Task<bool>>, CancellationToken)	Task<IEnumerable<TSource>>	From ParallelAsyncExtensions
RequireKeys<TKey, TValue>(IEnumerable<TKey>)	void	Verifies that a dictionary contains all requires keys. An `System.ArgumentException` will be thrown if the specified keys are not all present in the dictionary. From IReadOnlyDictionaryExtensions
RequireKeys<TKey, TValue>(TKey[])	void	Verifies that a dictionary contains all requires keys. An `System.ArgumentException` will be thrown if the specified keys are not all present in the dictionary. From IReadOnlyDictionaryExtensions
StartsWith<KeyValuePair<TKey, TValue>>(IEnumerable<KeyValuePair<TKey, TValue>>, IEqualityComparer<KeyValuePair<TKey, TValue>>)	bool	Determines whether the items starts with the specified values. From IEnumerableExtensions
StartsWith<KeyValuePair<TKey, TValue>>(IEnumerable<KeyValuePair<TKey, TValue>>)	bool	Determines whether the items starts with the specified values. From IEnumerableExtensions
ThrowIfNull<ConcurrentCache<TKey, TValue>>(string)	T	From GuardExtensions
ToDocument<ConcurrentCache<TKey, TValue>>(IContentProvider)	IDocument	From ObjectToDocumentExtensions
ToDocument<ConcurrentCache<TKey, TValue>>(IEnumerable<KeyValuePair<string, object>>, IContentProvider)	IDocument	From ObjectToDocumentExtensions
ToDocument<ConcurrentCache<TKey, TValue>>(NormalizedPath, IContentProvider)	IDocument	From ObjectToDocumentExtensions
ToDocument<ConcurrentCache<TKey, TValue>>(NormalizedPath, IEnumerable<KeyValuePair<string, object>>, IContentProvider)	IDocument	From ObjectToDocumentExtensions
ToDocument<ConcurrentCache<TKey, TValue>>(NormalizedPath, NormalizedPath, IContentProvider)	IDocument	From ObjectToDocumentExtensions
ToDocument<ConcurrentCache<TKey, TValue>>(NormalizedPath, NormalizedPath, IEnumerable<KeyValuePair<string, object>>, IContentProvider)	IDocument	From ObjectToDocumentExtensions
ToDocuments<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, IContentProvider>)	IEnumerable<IDocument>	From ObjectToDocumentExtensions
ToDocuments<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, IEnumerable<KeyValuePair<string, object>>>, Func<KeyValuePair<TKey, TValue>, IContentProvider>)	IEnumerable<IDocument>	From ObjectToDocumentExtensions
ToDocuments<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, NormalizedPath>, Func<KeyValuePair<TKey, TValue>, IContentProvider>)	IEnumerable<IDocument>	From ObjectToDocumentExtensions
ToDocuments<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, NormalizedPath>, Func<KeyValuePair<TKey, TValue>, IEnumerable<KeyValuePair<string, object>>>, Func<KeyValuePair<TKey, TValue>, IContentProvider>)	IEnumerable<IDocument>	From ObjectToDocumentExtensions
ToDocuments<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, NormalizedPath>, Func<KeyValuePair<TKey, TValue>, NormalizedPath>, Func<KeyValuePair<TKey, TValue>, IContentProvider>)	IEnumerable<IDocument>	From ObjectToDocumentExtensions
ToDocuments<KeyValuePair<TKey, TValue>>(Func<KeyValuePair<TKey, TValue>, NormalizedPath>, Func<KeyValuePair<TKey, TValue>, NormalizedPath>, Func<KeyValuePair<TKey, TValue>, IEnumerable<KeyValuePair<string, object>>>, Func<KeyValuePair<TKey, TValue>, IContentProvider>)	IEnumerable<IDocument>	From ObjectToDocumentExtensions
ToLookupMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, TElement>, IEqualityComparer<TKey>)	ILookup<TKey, TElement>	Creates a lookup from a sequence according to a specified key selector function that returns a sequence of keys. The keys are compared by using a comparer and each group's elements are projected by using a specified function. From ToLookupExtensions
ToLookupMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, TElement>)	ILookup<TKey, TElement>	Creates a lookup from a sequence according to a specified key selector function that returns a sequence of keys and projects the elements for each group by using a specified function. From ToLookupExtensions
ToLookupMany<KeyValuePair<TKey, TValue>, TKey>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, IEqualityComparer<TKey>)	ILookup<TKey, TSource>	Creates a lookup from a sequence according to a specified key selector function that returns a sequence of keys and compares the keys by using a specified comparer. From ToLookupExtensions
ToLookupMany<KeyValuePair<TKey, TValue>, TKey>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>)	ILookup<TKey, TSource>	Creates a lookup from a sequence according to a specified key selector function that returns a sequence of keys. From ToLookupExtensions
ToLookupManyToMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, IEnumerable<TElement>>, IEqualityComparer<TKey>)	ILookup<TKey, TElement>	Creates a lookup from a sequence according to a specified key selector function that returns a sequence of keys. The keys are compared by using a comparer and each group's elements are projected by using a specified function that returns a sequence of elements. From ToLookupExtensions
ToLookupManyToMany<KeyValuePair<TKey, TValue>, TKey, TElement>(Func<KeyValuePair<TKey, TValue>, IEnumerable<TKey>>, Func<KeyValuePair<TKey, TValue>, IEnumerable<TElement>>)	ILookup<TKey, TElement>	Creates a lookup from a sequence according to a specified key selector function that returns a sequence of keys and projects the elements for each group by using a specified function that returns a sequence of elements. From ToLookupExtensions
ToStringTable<KeyValuePair<TKey, TValue>>(string[], Func<KeyValuePair<TKey, TValue>, object>[])	string	From ToStringTableExtensions