Dictionary<TKey,TValue> Constructores

Definición

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue>.

Sobrecargas

Dictionary<TKey,TValue>()

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza el comparador de igualdad predeterminado para el tipo de clave.

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene los elementos copiados del IDictionary<TKey,TValue> especificado y utiliza el comparador de igualdad predeterminado para el tipo de clave.

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene elementos copiados del valor IEnumerable<T> especificado.

Dictionary<TKey,TValue>(IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza la interfaz IEqualityComparer<T> especificada.

Dictionary<TKey,TValue>(Int32)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza el comparador de igualdad predeterminado para el tipo de clave.

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene los elementos copiados de la interfaz IDictionary<TKey,TValue> especificada y utiliza la interfaz IEqualityComparer<T> especificada.

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene los elementos copiados de la interfaz IEnumerable<T> especificada y utiliza la interfaz IEqualityComparer<T> especificada.

Dictionary<TKey,TValue>(Int32, IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza la interfaz IEqualityComparer<T> especificada.

Dictionary<TKey,TValue>(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> con datos serializados.

Dictionary<TKey,TValue>()

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza el comparador de igualdad predeterminado para el tipo de clave.

public:
 Dictionary();
public Dictionary ();
Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se crea un vacío Dictionary<TKey,TValue> de cadenas con claves de cadena y se usa el Add método para agregar algunos elementos. En el ejemplo se muestra que el Add método produce un ArgumentException al intentar agregar una clave duplicada.

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la Dictionary<TKey,TValue> clase .

// 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

Comentarios

Cada clave de un Dictionary<TKey,TValue> debe ser única según el comparador de igualdad predeterminado.

Dictionary<TKey,TValue> requiere una implementación de igualdad para determinar si las claves son iguales. Este constructor usa el comparador de igualdad genérico predeterminado, EqualityComparer<T>.Default. Si type TKey implementa la System.IEquatable<T> interfaz genérica, el comparador de igualdad predeterminado usa esa implementación. Como alternativa, puede especificar una implementación de la IEqualityComparer<T> interfaz genérica mediante un constructor que acepte un comparer parámetro.

Nota

Si puede calcular el tamaño de la colección, mediante un constructor que especifica la capacidad inicial elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al agregar elementos a Dictionary<TKey,TValue>.

Este constructor es una operación O(1).

Consulte también

Se aplica a

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene los elementos copiados del IDictionary<TKey,TValue> especificado y utiliza el comparador de igualdad predeterminado para el tipo de clave.

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))

Parámetros

dictionary
IDictionary<TKey,TValue>

IDictionary<TKey,TValue> cuyos elementos se copian en el nuevo Dictionary<TKey,TValue>.

Excepciones

dictionary es null.

dictionary contiene una o varias claves duplicadas.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Dictionary<TKey,TValue>(IEqualityComparer<TKey>) constructor para inicializar con Dictionary<TKey,TValue> contenido ordenado de otro diccionario. En el ejemplo de código se crea y SortedDictionary<TKey,TValue> se rellena con datos en orden aleatorio y, a continuación, se pasa al SortedDictionary<TKey,TValue> Dictionary<TKey,TValue>(IEqualityComparer<TKey>) constructor y se crea un Dictionary<TKey,TValue> objeto ordenado. Esto es útil si necesita crear un diccionario ordenado que, en algún momento, se convierte en estático; copiar los datos de a SortedDictionary<TKey,TValue> una Dictionary<TKey,TValue> mejora la velocidad de recuperación.

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

Comentarios

Cada clave de un Dictionary<TKey,TValue> debe ser única según el comparador de igualdad predeterminado; del mismo modo, todas las claves del dictionary origen también deben ser únicas según el comparador de igualdad predeterminado.

La capacidad inicial del nuevo Dictionary<TKey,TValue> es lo suficientemente grande como para contener todos los elementos de dictionary.

Dictionary<TKey,TValue> requiere una implementación de igualdad para determinar si las claves son iguales. Este constructor usa el comparador de igualdad genérico predeterminado, EqualityComparer<T>.Default. Si type TKey implementa la System.IEquatable<T> interfaz genérica, el comparador de igualdad predeterminado usa esa implementación. Como alternativa, puede especificar una implementación de la IEqualityComparer<T> interfaz genérica mediante un constructor que acepte un comparer parámetro.

Este constructor es una operación O(n), donde n es el número de elementos de dictionary.

Consulte también

Se aplica a

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene elementos copiados del valor IEnumerable<T> especificado.

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)))

Parámetros

collection
IEnumerable<KeyValuePair<TKey,TValue>>

IEnumerable<T> cuyos elementos se copian en el nuevo elemento Dictionary<TKey,TValue>.

Excepciones

collection es null.

collection contiene una o varias claves duplicadas.

Se aplica a

Dictionary<TKey,TValue>(IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza la interfaz IEqualityComparer<T> especificada.

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))

Parámetros

comparer
IEqualityComparer<TKey>

Implementación de IEqualityComparer<T> que se va a utilizar para comparar claves o null si se va a utilizar el EqualityComparer<T> predeterminado para el tipo de la clave.

Ejemplos

En el ejemplo de código siguiente se crea un Dictionary<TKey,TValue> objeto con un comparador de igualdad sin distinción entre mayúsculas y minúsculas para la referencia cultural actual. En el ejemplo se agregan cuatro elementos, algunos con claves minúsculas y algunas con claves mayúsculas. A continuación, el ejemplo intenta agregar un elemento con una clave que difiere de una clave existente solo por caso, detecta la excepción resultante y muestra un mensaje de error. Por último, en el ejemplo se muestran los elementos del diccionario.

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

Comentarios

Use este constructor con los comparadores de cadenas que no distinguen mayúsculas de minúsculas proporcionados por la StringComparer clase para crear diccionarios con claves de cadena que no distinguen mayúsculas de minúsculas.

Cada clave de un Dictionary<TKey,TValue> debe ser única según el comparador especificado.

Dictionary<TKey,TValue> requiere una implementación de igualdad para determinar si las claves son iguales. Si comparer es null, este constructor usa el comparador de igualdad genérico predeterminado, EqualityComparer<T>.Default. Si type TKey implementa la System.IEquatable<T> interfaz genérica, el comparador de igualdad predeterminado usa esa implementación.

Nota

Si puede calcular el tamaño de la colección, mediante un constructor que especifica la capacidad inicial elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al agregar elementos a Dictionary<TKey,TValue>.

Este constructor es una operación O(1).

Consulte también

Se aplica a

Dictionary<TKey,TValue>(Int32)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza el comparador de igualdad predeterminado para el tipo de clave.

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)

Parámetros

capacity
Int32

Número inicial de elementos que puede contener la colección Dictionary<TKey,TValue>.

Excepciones

capacity es menor que 0.

Ejemplos

En el ejemplo de código siguiente se crea un diccionario con una capacidad inicial de 4 y se rellena con 4 entradas.

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

Comentarios

Cada clave de un Dictionary<TKey,TValue> debe ser única según el comparador de igualdad predeterminado.

La capacidad de un Dictionary<TKey,TValue> es el número de elementos que se pueden agregar a Dictionary<TKey,TValue> antes de que sea necesario cambiar el tamaño. A medida que se agregan elementos a , Dictionary<TKey,TValue>la capacidad aumenta automáticamente según sea necesario mediante la reasignación de la matriz interna.

Si se puede estimar el tamaño de la colección, especificar la capacidad inicial elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al agregar elementos a Dictionary<TKey,TValue>.

Dictionary<TKey,TValue> requiere una implementación de igualdad para determinar si las claves son iguales. Este constructor usa el comparador de igualdad genérico predeterminado, EqualityComparer<T>.Default. Si type TKey implementa la System.IEquatable<T> interfaz genérica, el comparador de igualdad predeterminado usa esa implementación. Como alternativa, puede especificar una implementación de la IEqualityComparer<T> interfaz genérica mediante un constructor que acepte un comparer parámetro.

Este constructor es una operación O(1).

Consulte también

Se aplica a

Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene los elementos copiados de la interfaz IDictionary<TKey,TValue> especificada y utiliza la interfaz IEqualityComparer<T> especificada.

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))

Parámetros

dictionary
IDictionary<TKey,TValue>

IDictionary<TKey,TValue> cuyos elementos se copian en el nuevo Dictionary<TKey,TValue>.

comparer
IEqualityComparer<TKey>

Implementación de IEqualityComparer<T> que se va a utilizar para comparar claves o null si se va a utilizar el EqualityComparer<T> predeterminado para el tipo de la clave.

Excepciones

dictionary es null.

dictionary contiene una o varias claves duplicadas.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) constructor para inicializar un Dictionary<TKey,TValue> objeto con contenido ordenado sin distinción entre mayúsculas y minúsculas de otro diccionario. En el Dictionary<TKey,TValue>(IDictionary<TKey,TValue>, IEqualityComparer<TKey>) ejemplo de código se crea un SortedDictionary<TKey,TValue> objeto con un comparador que no distingue mayúsculas de minúsculas y se rellena con datos en orden aleatorio y, a continuación, se pasa al SortedDictionary<TKey,TValue> constructor, junto con un comparador de igualdad sin distinción entre mayúsculas y minúsculas, lo que crea un Dictionary<TKey,TValue> que se ordena. Esto resulta útil si necesita crear un diccionario ordenado que en algún momento se convierte en estático; copiar los datos de a SortedDictionary<TKey,TValue> a Dictionary<TKey,TValue> mejora la velocidad de recuperación.

Nota

Cuando se crea un nuevo diccionario con un comparador que no distingue mayúsculas de minúsculas y se rellena con entradas de un diccionario que usa un comparador que distingue mayúsculas de minúsculas, como en este ejemplo, se produce una excepción si el diccionario de entrada tiene claves que solo difieren por mayúsculas y minúsculas.

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

Comentarios

Use este constructor con los comparadores de cadenas que no distinguen mayúsculas de minúsculas proporcionados por la StringComparer clase para crear diccionarios con claves de cadena que no distinguen mayúsculas de minúsculas.

Cada clave de un Dictionary<TKey,TValue> debe ser única según el comparador especificado; del mismo modo, todas las claves del dictionary origen también deben ser únicas según el comparador especificado.

Nota

Por ejemplo, las claves duplicadas pueden producirse si comparer es uno de los comparadores de cadenas que no distinguen mayúsculas de minúsculas proporcionados por la StringComparer clase y dictionary no usa una clave de comparador que no distingue mayúsculas de minúsculas.

La capacidad inicial del nuevo Dictionary<TKey,TValue> es lo suficientemente grande como para contener todos los elementos de dictionary.

Dictionary<TKey,TValue> requiere una implementación de igualdad para determinar si las claves son iguales. Si comparer es null, este constructor usa el comparador de igualdad genérico predeterminado, EqualityComparer<T>.Default. Si type TKey implementa la System.IEquatable<T> interfaz genérica, el comparador de igualdad predeterminado usa esa implementación.

Este constructor es una operación O(n), donde n es el número de elementos de dictionary.

Consulte también

Se aplica a

Dictionary<TKey,TValue>(IEnumerable<KeyValuePair<TKey,TValue>>, IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que contiene los elementos copiados de la interfaz IEnumerable<T> especificada y utiliza la interfaz IEqualityComparer<T> especificada.

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))

Parámetros

collection
IEnumerable<KeyValuePair<TKey,TValue>>

IEnumerable<T> cuyos elementos se copian en el nuevo Dictionary<TKey,TValue>.

comparer
IEqualityComparer<TKey>

Implementación de IEqualityComparer<T> que se va a utilizar para comparar claves o null si se va a utilizar el EqualityComparer<T> predeterminado para el tipo de la clave.

Excepciones

collection es null.

collection contiene una o varias claves duplicadas.

Se aplica a

Dictionary<TKey,TValue>(Int32, IEqualityComparer<TKey>)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza la interfaz IEqualityComparer<T> especificada.

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))

Parámetros

capacity
Int32

Número inicial de elementos que puede contener la colección Dictionary<TKey,TValue>.

comparer
IEqualityComparer<TKey>

Implementación de IEqualityComparer<T> que se va a utilizar para comparar claves o null si se va a utilizar el EqualityComparer<T> predeterminado para el tipo de la clave.

Excepciones

capacity es menor que 0.

Ejemplos

En el ejemplo de código siguiente se crea un Dictionary<TKey,TValue> objeto con una capacidad inicial de 5 y un comparador de igualdad sin distinción entre mayúsculas y minúsculas para la referencia cultural actual. En el ejemplo se agregan cuatro elementos, algunos con claves en minúsculas y otras con claves mayúsculas. A continuación, el ejemplo intenta agregar un elemento con una clave que difiere de una clave existente solo por caso, detecta la excepción resultante y muestra un mensaje de error. Por último, en el ejemplo se muestran los elementos del diccionario.

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

Comentarios

Use este constructor con los comparadores de cadenas que no distinguen mayúsculas de minúsculas proporcionados por la StringComparer clase para crear diccionarios con claves de cadena que no distinguen mayúsculas de minúsculas.

Cada clave de un Dictionary<TKey,TValue> debe ser única según el comparador especificado.

La capacidad de es Dictionary<TKey,TValue> el número de elementos que se pueden agregar a antes de que sea necesario cambiar el Dictionary<TKey,TValue> tamaño. A medida que se agregan elementos a , Dictionary<TKey,TValue>la capacidad aumenta automáticamente según sea necesario mediante la reasignación de la matriz interna.

Si se puede estimar el tamaño de la colección, especificar la capacidad inicial elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al agregar elementos a Dictionary<TKey,TValue>.

Dictionary<TKey,TValue> requiere una implementación de igualdad para determinar si las claves son iguales. Si comparer es null, este constructor usa el comparador de igualdad genérico predeterminado, EqualityComparer<T>.Default. Si type TKey implementa la System.IEquatable<T> interfaz genérica, el comparador de igualdad predeterminado usa esa implementación.

Este constructor es una operación O(1).

Consulte también

Se aplica a

Dictionary<TKey,TValue>(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase Dictionary<TKey,TValue> con datos serializados.

protected:
 Dictionary(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
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>
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parámetros

info
SerializationInfo

Objeto SerializationInfo que contiene la información que se requiere para serializar Dictionary<TKey,TValue>.

context
StreamingContext

Estructura StreamingContext que contiene el origen y el destino de la secuencia serializada asociada a Dictionary<TKey,TValue>.

Comentarios

Se llama a este constructor durante la deserialización para reconstituir un objeto transmitido a través de una secuencia. Para obtener más información, vea Serialización XML y SOAP.

Consulte también

Se aplica a