Dictionary<TKey,TValue> Constructeurs

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary();

public Dictionary ();

Public Sub New ()

Exemples

L’exemple de code suivant crée un vide Dictionary<TKey,TValue> de chaînes avec des clés de chaîne et utilise la Add méthode pour ajouter des éléments. L’exemple montre que la Add méthode lève un ArgumentException lors de la tentative d’ajout d’une clé en double.

Cet exemple de code fait partie d’un exemple plus grand fourni pour la Dictionary<TKey,TValue> classe .

// Create a new dictionary of strings, with string keys.
//
Dictionary<String^, String^>^ openWith =
    gcnew Dictionary<String^, String^>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith->Add("txt", "notepad.exe");
openWith->Add("bmp", "paint.exe");
openWith->Add("dib", "paint.exe");
openWith->Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}

// Create a new dictionary of strings, with string keys.
//
Dictionary<string, string> openWith =
    new Dictionary<string, string>();

// Add some elements to the dictionary. There are no
// duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe");
openWith.Add("bmp", "paint.exe");
openWith.Add("dib", "paint.exe");
openWith.Add("rtf", "wordpad.exe");

// The Add method throws an exception if the new key is
// already in the dictionary.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}

' Create a new dictionary of strings, with string keys.
'
Dim openWith As New Dictionary(Of String, String)

' Add some elements to the dictionary. There are no 
' duplicate keys, but some of the values are duplicates.
openWith.Add("txt", "notepad.exe")
openWith.Add("bmp", "paint.exe")
openWith.Add("dib", "paint.exe")
openWith.Add("rtf", "wordpad.exe")

' The Add method throws an exception if the new key is 
' already in the dictionary.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Remarques

Chaque clé d’un Dictionary<TKey,TValue> doit être unique en fonction du comparateur d’égalité par défaut.

Dictionary<TKey,TValue> nécessite une implémentation d’égalité pour déterminer si les clés sont égales. Ce constructeur utilise le comparateur d’égalité générique par défaut, EqualityComparer<T>.Default. Si type TKey implémente l’interface System.IEquatable<T> générique, le comparateur d’égalité par défaut utilise cette implémentation. Vous pouvez également spécifier une implémentation de l’interface générique à l’aide IEqualityComparer<T> d’un constructeur qui accepte un comparer paramètre.

Ce constructeur est une opération O(1).

Voir aussi

• IImmutableDictionary<TKey,TValue>
• Default
• IEquatable<T>

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary);

public Dictionary (System.Collections.Generic.IDictionary<TKey,TValue> dictionary);

new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> -> System.Collections.Generic.Dictionary<'Key, 'Value>

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

Paramètres

Exceptions

Exemples

L’exemple de code suivant montre comment utiliser le Dictionary<TKey,TValue>(IEqualityComparer<TKey>) constructeur pour initialiser un avec du Dictionary<TKey,TValue> contenu trié à partir d’un autre dictionnaire. L’exemple de code crée un SortedDictionary<TKey,TValue> et le remplit avec des données dans un ordre aléatoire, puis transmet au Dictionary<TKey,TValue>(IEqualityComparer<TKey>)SortedDictionary<TKey,TValue> constructeur, en créant un Dictionary<TKey,TValue> trié. Cela est utile si vous avez besoin de créer un dictionnaire trié qui, à un moment donné, devient statique ; la copie des données d’un SortedDictionary<TKey,TValue> vers un Dictionary<TKey,TValue> améliore la vitesse de récupération.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted dictionary of strings, with string
        // keys.
        SortedDictionary<string, string> openWith =
            new SortedDictionary<string, string>();

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Create a Dictionary of strings with string keys, and
        // initialize it with the contents of the sorted dictionary.
        Dictionary<string, string> copy =
            new Dictionary<string, string>(openWith);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */

Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted dictionary of strings, with string 
        ' keys.
        Dim openWith As New SortedDictionary(Of String, String)
        
        ' Add some elements to the sorted dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a Dictionary of strings with string keys, and 
        ' initialize it with the contents of the sorted dictionary.
        Dim copy As New Dictionary(Of String, String)(openWith)

        ' List the contents of the copy.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In copy
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

Remarques

Chaque clé d’un Dictionary<TKey,TValue> doit être unique selon le comparateur d’égalité par défaut ; de même, chaque clé de la source dictionary doit également être unique selon le comparateur d’égalité par défaut.

La capacité initiale du nouveau Dictionary<TKey,TValue> est suffisamment grande pour contenir tous les éléments dans dictionary.

Dictionary<TKey,TValue> nécessite une implémentation d’égalité pour déterminer si les clés sont égales. Ce constructeur utilise le comparateur d’égalité générique par défaut, EqualityComparer<T>.Default. Si type TKey implémente l’interface System.IEquatable<T> générique, le comparateur d’égalité par défaut utilise cette implémentation. Vous pouvez également spécifier une implémentation de l’interface générique à l’aide IEqualityComparer<T> d’un constructeur qui accepte un comparer paramètre.

Ce constructeur est une opération O(n), où n est le nombre d’éléments dans dictionary.

Voir aussi

• IDictionary<TKey,TValue>
• Default
• IEquatable<T>

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ collection);

public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> collection);

new System.Collections.Generic.Dictionary<'Key, 'Value> : seq<System.Collections.Generic.KeyValuePair<'Key, 'Value>> -> System.Collections.Generic.Dictionary<'Key, 'Value>

Public Sub New (collection As IEnumerable(Of KeyValuePair(Of TKey, TValue)))

Paramètres

Exceptions

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

public Dictionary (System.Collections.Generic.IEqualityComparer<TKey> comparer);

public Dictionary (System.Collections.Generic.IEqualityComparer<TKey>? comparer);

new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>

Public Sub New (comparer As IEqualityComparer(Of TKey))

Paramètres

Exemples

L’exemple de code suivant crée un Dictionary<TKey,TValue> avec un comparateur d’égalité ne respectant pas la casse pour la culture actuelle. L’exemple ajoute quatre éléments, certains avec des touches minuscules et d’autres avec des clés majuscules. L’exemple tente ensuite d’ajouter un élément avec une clé qui diffère d’une clé existante uniquement par la casse, intercepte l’exception résultante et affiche un message d’erreur. Enfin, l’exemple affiche les éléments dans le dictionnaire.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new Dictionary of strings, with string keys
        // and a case-insensitive comparer for the current culture.
        Dictionary<string, string> openWith =
                      new Dictionary<string, string>(
                          StringComparer.CurrentCultureIgnoreCase);

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the dictionary.");
        }

        // List the contents of the sorted dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */

Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new Dictionary of strings, with string keys 
        ' and a case-insensitive comparer for the current culture.
        Dim openWith As New Dictionary(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the dictionary.")
        End Try
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the dictionary.
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe

Remarques

Utilisez ce constructeur avec les comparateurs de chaînes ne respectant pas la casse fournis par la StringComparer classe pour créer des dictionnaires avec des clés de chaîne ne respectant pas la casse.

Chaque clé d’un Dictionary<TKey,TValue> doit être unique en fonction du comparateur spécifié.

Dictionary<TKey,TValue> nécessite une implémentation d’égalité pour déterminer si les clés sont égales. Si comparer a la valeur null, ce constructeur utilise le comparateur d’égalité générique par défaut, EqualityComparer<T>.Default. Si type TKey implémente l’interface System.IEquatable<T> générique, le comparateur d’égalité par défaut utilise cette implémentation.

Ce constructeur est une opération O(1).

Voir aussi

• IEqualityComparer<T>
• Default
• IEquatable<T>

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(int capacity);

public Dictionary (int capacity);

new System.Collections.Generic.Dictionary<'Key, 'Value> : int -> System.Collections.Generic.Dictionary<'Key, 'Value>

Public Sub New (capacity As Integer)

Paramètres

Exceptions

Exemples

L’exemple de code suivant crée un dictionnaire d’une capacité initiale de 4 et le remplit avec 4 entrées.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys and
        // an initial capacity of 4.
        Dictionary<string, string> openWith =
                               new Dictionary<string, string>(4);

        // Add 4 elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // List the contents of the dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = dib, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */

Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new dictionary of strings, with string keys and
        ' an initial capacity of 4.
        Dim openWith As New Dictionary(Of String, String)(4)
        
        ' Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe

Remarques

Chaque clé d’un Dictionary<TKey,TValue> doit être unique en fonction du comparateur d’égalité par défaut.

La capacité d’un Dictionary<TKey,TValue> est le nombre d’éléments qui peuvent être ajoutés à avant que le Dictionary<TKey,TValue> redimensionnement ne soit nécessaire. À mesure que des éléments sont ajoutés à un Dictionary<TKey,TValue>, la capacité est automatiquement augmentée en fonction des besoins en réaffectant le tableau interne.

Si la taille de la collection peut être estimée, la spécification de la capacité initiale élimine la nécessité d’effectuer un certain nombre d’opérations de redimensionnement lors de l’ajout Dictionary<TKey,TValue>d’éléments au .

Dictionary<TKey,TValue> nécessite une implémentation d’égalité pour déterminer si les clés sont égales. Ce constructeur utilise le comparateur d’égalité générique par défaut, EqualityComparer<T>.Default. Si type TKey implémente l’interface System.IEquatable<T> générique, le comparateur d’égalité par défaut utilise cette implémentation. Vous pouvez également spécifier une implémentation de l’interface générique à l’aide IEqualityComparer<T> d’un constructeur qui accepte un comparer paramètre.

Ce constructeur est une opération O(1).

Voir aussi

• Default
• IEquatable<T>

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

public Dictionary (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IEqualityComparer<TKey> comparer);

public Dictionary (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>

Public Sub New (dictionary As IDictionary(Of TKey, TValue), comparer As IEqualityComparer(Of TKey))

Paramètres

Exceptions

Exemples

L’exemple de code suivant montre comment utiliser le Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) constructeur pour initialiser un avec un Dictionary<TKey,TValue> contenu trié ne respectant pas la casse à partir d’un autre dictionnaire. L’exemple de code crée un SortedDictionary<TKey,TValue> avec un comparateur ne respectant pas la casse et le remplit avec des données dans un ordre aléatoire, puis passe au constructeur, ainsi qu’un comparateur d’égalité ne respectant pas la SortedDictionary<TKey,TValue>Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) casse, créant un Dictionary<TKey,TValue> trié. Cela est utile si vous avez besoin de créer un dictionnaire trié qui, à un moment donné, devient statique ; la copie des données d’un SortedDictionary<TKey,TValue> vers un Dictionary<TKey,TValue> améliore la vitesse de récupération.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted dictionary of strings, with string
        // keys and a case-insensitive comparer.
        SortedDictionary<string, string> openWith =
                new SortedDictionary<string, string>(
                    StringComparer.CurrentCultureIgnoreCase);

        // Add some elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("Bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Create a Dictionary of strings with string keys and a
        // case-insensitive equality comparer, and initialize it
        // with the contents of the sorted dictionary.
        Dictionary<string, string> copy =
                new Dictionary<string, string>(openWith,
                    StringComparer.CurrentCultureIgnoreCase);

        // List the contents of the copy.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in copy )
        {
            Console.WriteLine("Key = {0}, Value = {1}",
               kvp.Key, kvp.Value);
        }
    }
}

/* This code example produces the following output:

Key = Bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
 */

Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new sorted dictionary of strings, with string 
        ' keys and a case-insensitive comparer.
        Dim openWith As New SortedDictionary(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the sorted dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("Bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")
        
        ' Create a Dictionary of strings with string keys and a 
        ' case-insensitive equality comparer, and initialize it
        ' with the contents of the sorted dictionary.
        Dim copy As New Dictionary(Of String, String)(openWith, _
            StringComparer.CurrentCultureIgnoreCase)

        ' List the contents of the copy.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In copy
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'Key = Bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

Remarques

Utilisez ce constructeur avec les comparateurs de chaînes ne respectant pas la casse fournis par la StringComparer classe pour créer des dictionnaires avec des clés de chaîne ne respectant pas la casse.

Chaque clé d’un Dictionary<TKey,TValue> doit être unique selon le comparateur spécifié ; de même, chaque clé de la source dictionary doit également être unique en fonction du comparateur spécifié.

La capacité initiale du nouveau Dictionary<TKey,TValue> est suffisamment grande pour contenir tous les éléments dans dictionary.

Dictionary<TKey,TValue> nécessite une implémentation d’égalité pour déterminer si les clés sont égales. Si comparer a la valeur null, ce constructeur utilise le comparateur d’égalité générique par défaut, EqualityComparer<T>.Default. Si type TKey implémente l’interface System.IEquatable<T> générique, le comparateur d’égalité par défaut utilise cette implémentation.

Ce constructeur est une opération O(n), où n est le nombre d’éléments dans dictionary.

Voir aussi

• IDictionary<TKey,TValue>
• IEqualityComparer<T>
• Default
• IEquatable<T>

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>> ^ collection, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> collection, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

public Dictionary (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>> collection, System.Collections.Generic.IEqualityComparer<TKey> comparer);

new System.Collections.Generic.Dictionary<'Key, 'Value> : seq<System.Collections.Generic.KeyValuePair<'Key, 'Value>> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>

Public Sub New (collection As IEnumerable(Of KeyValuePair(Of TKey, TValue)), comparer As IEqualityComparer(Of TKey))

Paramètres

Exceptions

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

public:
 Dictionary(int capacity, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

public Dictionary (int capacity, System.Collections.Generic.IEqualityComparer<TKey> comparer);

public Dictionary (int capacity, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

new System.Collections.Generic.Dictionary<'Key, 'Value> : int * System.Collections.Generic.IEqualityComparer<'Key> -> System.Collections.Generic.Dictionary<'Key, 'Value>

Public Sub New (capacity As Integer, comparer As IEqualityComparer(Of TKey))

Paramètres

Exceptions

Exemples

L’exemple de code suivant crée un Dictionary<TKey,TValue> avec une capacité initiale de 5 et un comparateur d’égalité ne respectant pas la casse pour la culture actuelle. L’exemple ajoute quatre éléments, certains avec des touches minuscules et d’autres avec des clés majuscules. L’exemple tente ensuite d’ajouter un élément avec une clé qui diffère d’une clé existante uniquement par la casse, intercepte l’exception résultante et affiche un message d’erreur. Enfin, l’exemple affiche les éléments dans le dictionnaire.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new dictionary of strings, with string keys, an
        // initial capacity of 5, and a case-insensitive equality
        // comparer.
        Dictionary<string, string> openWith =
                      new Dictionary<string, string>(5,
                          StringComparer.CurrentCultureIgnoreCase);

        // Add 4 elements to the dictionary.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("DIB", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // Try to add a fifth element with a key that is the same
        // except for case; this would be allowed with the default
        // comparer.
        try
        {
            openWith.Add("BMP", "paint.exe");
        }
        catch (ArgumentException)
        {
            Console.WriteLine("\nBMP is already in the dictionary.");
        }

        // List the contents of the dictionary.
        Console.WriteLine();
        foreach( KeyValuePair<string, string> kvp in openWith )
        {
            Console.WriteLine("Key = {0}, Value = {1}", kvp.Key,
                kvp.Value);
        }
    }
}

/* This code example produces the following output:

BMP is already in the dictionary.

Key = txt, Value = notepad.exe
Key = bmp, Value = paint.exe
Key = DIB, Value = paint.exe
Key = rtf, Value = wordpad.exe
 */

Imports System.Collections.Generic

Public Class Example
    
    Public Shared Sub Main() 

        ' Create a new Dictionary of strings, with string keys, an
        ' initial capacity of 5, and a case-insensitive equality
        ' comparer.
        Dim openWith As New Dictionary(Of String, String)(5, _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add 4 elements to the dictionary. 
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("DIB", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' Try to add a fifth element with a key that is the same 
        ' except for case; this would be allowed with the default
        ' comparer.
        Try
            openWith.Add("BMP", "paint.exe")
        Catch ex As ArgumentException
            Console.WriteLine(vbLf & "BMP is already in the dictionary.")
        End Try
        
        ' List the contents of the dictionary.
        Console.WriteLine()
        For Each kvp As KeyValuePair(Of String, String) In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                kvp.Key, kvp.Value)
        Next kvp

    End Sub

End Class

' This code example produces the following output:
'
'BMP is already in the dictionary.
'
'Key = txt, Value = notepad.exe
'Key = bmp, Value = paint.exe
'Key = DIB, Value = paint.exe
'Key = rtf, Value = wordpad.exe

Remarques

Utilisez ce constructeur avec les comparateurs de chaînes ne respectant pas la casse fournis par la StringComparer classe pour créer des dictionnaires avec des clés de chaîne ne respectant pas la casse.

Chaque clé d’un Dictionary<TKey,TValue> doit être unique en fonction du comparateur spécifié.

La capacité d’un Dictionary<TKey,TValue> est le nombre d’éléments qui peuvent être ajoutés à avant que le Dictionary<TKey,TValue> redimensionnement ne soit nécessaire. À mesure que des éléments sont ajoutés à un Dictionary<TKey,TValue>, la capacité est automatiquement augmentée en fonction des besoins en réaffectant le tableau interne.

Si la taille de la collection peut être estimée, la spécification de la capacité initiale élimine la nécessité d’effectuer un certain nombre d’opérations de redimensionnement lors de l’ajout Dictionary<TKey,TValue>d’éléments au .

Dictionary<TKey,TValue> nécessite une implémentation d’égalité pour déterminer si les clés sont égales. Si comparer a la valeur null, ce constructeur utilise le comparateur d’égalité générique par défaut, EqualityComparer<T>.Default. Si type TKey implémente l’interface System.IEquatable<T> générique, le comparateur d’égalité par défaut utilise cette implémentation.

Ce constructeur est une opération O(1).

Voir aussi

• IEqualityComparer<T>
• Default
• IEquatable<T>

Source:

Dictionary.cs

Source:

Dictionary.cs

Source:

Dictionary.cs

protected:
 Dictionary(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected Dictionary (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Dictionary (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Generic.Dictionary<'Key, 'Value>

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Collections.Generic.Dictionary<'Key, 'Value> : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Generic.Dictionary<'Key, 'Value>

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Paramètres

Attributs

ObsoleteAttribute

Remarques

Ce constructeur est appelé lors de la désérialisation pour reconstituer un objet transmis sur un flux. Pour plus d’informations, consultez Sérialisation XML et SOAP.

Voir aussi

• System.Runtime.Serialization