FileBackedDictionaryTKey, TValue(String, IDictionaryTKey, TValue) Constructor

Creates a new instance of the FileBackedDictionaryTKey, TValue class.

Namespace: GSF.Collections
Assembly: GSF.Core (in GSF.Core.dll) Version: 2.4.181-beta

Syntax

C++

JavaScript

Copy

public FileBackedDictionary(
	string filePath,
	IDictionary<TKey, TValue> dictionary
)

Public Sub New ( 
	filePath As String,
	dictionary As IDictionary(Of TKey, TValue)
)

public:
FileBackedDictionary(
	String^ filePath, 
	IDictionary<TKey, TValue>^ dictionary
)

new : 
        filePath : string * 
        dictionary : IDictionary<'TKey, 'TValue> -> FileBackedDictionary

GSF.Collections.FileBackedDictionary = function(filePath, dictionary);

View Source

Parameters

filePath String: The path to the file used to store the lookup table.
dictionary IDictionaryTKey, TValue: The dictionary whose elements are copied to this dictionary.

Exceptions

Exception	Condition
ArgumentException	filePath is a zero-length string, contains only white space, or contains one or more invalid characters as defined by GetInvalidPathChars.
ArgumentNullException	filePath is null or dictionary is null.
InvalidOperationException	Either TKey or TValue cannot be serialized.

Remarks

This constructor uses the default equality comparer for file backed lookup tables, which is not the same as the default equality comparer for TKey objects. This is because the default implementation of GetHashCode does not provide guarantees about consistency across platforms, or even implementations of the CLR. Instead, the default equality comparer uses a byte-for-byte comparison to determine equality between keys and a CRC-32 for its hash code implementation. This means the performance of the hashing function is dependent on the performance of the serialization function.

Reference

FileBackedDictionaryTKey, TValue Class

FileBackedDictionaryTKey, TValue Overload

GSF.Collections Namespace