Enumerable.ToDictionary<TSource, TKey> Method (IEnumerable<TSource>, Func<TSource, TKey>, IEqualityComparer<TKey>)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Creates a Dictionary<TKey, TValue> from an IEnumerable<T> according to a specified key selector function and key comparer.
Namespace: System.Linq
Assembly: System.Core (in System.Core.dll)
Syntax
'Declaration
<ExtensionAttribute> _
Public Shared Function ToDictionary(Of TSource, TKey) ( _
source As IEnumerable(Of TSource), _
keySelector As Func(Of TSource, TKey), _
comparer As IEqualityComparer(Of TKey) _
) As Dictionary(Of TKey, TSource)
public static Dictionary<TKey, TSource> ToDictionary<TSource, TKey>(
this IEnumerable<TSource> source,
Func<TSource, TKey> keySelector,
IEqualityComparer<TKey> comparer
)
Type Parameters
- TSource
The type of the elements of source.
- TKey
The type of the keys returned by keySelector.
Parameters
- source
Type: System.Collections.Generic.IEnumerable<TSource>
An IEnumerable<T> to create a Dictionary<TKey, TValue> from.
- keySelector
Type: System.Func<TSource, TKey>
A function to extract a key from each element.
- comparer
Type: System.Collections.Generic.IEqualityComparer<TKey>
An IEqualityComparer<T> to compare keys.
Return Value
Type: System.Collections.Generic.Dictionary<TKey, TSource>
A Dictionary<TKey, TValue> that contains keys and values.
Usage Note
In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerable<TSource>. When you use instance method syntax to call this method, omit the first parameter.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | source or keySelector is nulla null reference (Nothing in Visual Basic). -or- keySelector produces a key that is nulla null reference (Nothing in Visual Basic). |
| ArgumentException | keySelector produces duplicate keys for two elements. |
Remarks
If comparer is nulla null reference (Nothing in Visual Basic), the default equality comparer Default is used to compare keys.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.