DictionaryExtensionsGetActualValueOrDefaultTKey, TValue, TActualValue(IEnumerableKeyValuePairTKey, TValue, TKey, FuncTActualValue) Method

Tries to get the typed value from a dictionary for the given key. Unlike in the GetValueOrDefaultTKey, TValue(IEnumerableKeyValuePairTKey, TValue, TKey, FuncTValue) overload, here defaultValueFactory can return an instance of a different type than TValue.
See the Examples section of the GetValueOrDefaultTActualValue(IDictionaryString, Object, String, TActualValue) method for some examples.

Definition

Namespace: KGySoft.CoreLibraries
Assembly: KGySoft.CoreLibraries (in KGySoft.CoreLibraries.dll) Version: 10.0.0

C#

public static TActualValue GetActualValueOrDefault<TKey, TValue, TActualValue>(
	this IEnumerable<KeyValuePair<TKey, TValue>> dictionary,
	TKey key,
	Func<TActualValue> defaultValueFactory
)
where TActualValue : TValue

VB

<ExtensionAttribute>
Public Shared Function GetActualValueOrDefault(Of TKey, TValue, TActualValue As TValue) ( 
	dictionary As IEnumerable(Of KeyValuePair(Of TKey, TValue)),
	key As TKey,
	defaultValueFactory As Func(Of TActualValue)
) As TActualValue

C++

public:
[ExtensionAttribute]
generic<typename TKey, typename TValue, typename TActualValue>
where TActualValue : TValue
static TActualValue GetActualValueOrDefault(
	IEnumerable<KeyValuePair<TKey, TValue>>^ dictionary, 
	TKey key, 
	Func<TActualValue>^ defaultValueFactory
)

F#

[<ExtensionAttribute>]
static member GetActualValueOrDefault : 
        dictionary : IEnumerable<KeyValuePair<'TKey, 'TValue>> * 
        key : 'TKey * 
        defaultValueFactory : Func<'TActualValue> -> 'TActualValue  when 'TActualValue : 'TValue

Parameters

dictionary IEnumerableKeyValuePairTKey, TValue: The dictionary.
key TKey: The key whose value to get.
defaultValueFactory FuncTActualValue: A delegate that can be invoked to return a default value if key was not found.

Type Parameters

TKey: The type of the stored keys in the dictionary.
TValue: Type of the stored values in the dictionary.
TActualValue: The type of the value with the corresponding key to get.

Return Value

TActualValue
The found value or the result of defaultValueFactory if key was not found in the dictionary.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerableKeyValuePairTKey, TValue. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

Note

If dictionary is neither an IDictionaryTKey, TValue, nor an IReadOnlyDictionaryTKey, TValue instance, then a sequential lookup is performed using a default equality comparer on the keys.