SortedList<TKey,TValue> SortedList<TKey,TValue> SortedList<TKey,TValue> SortedList<TKey,TValue> Constructors

Definición

Sobrecargas

SortedList<TKey,TValue>() SortedList<TKey,TValue>() SortedList<TKey,TValue>()

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza la interfaz IComparer<T> predeterminada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the default initial capacity, and uses the default IComparer<T>.

SortedList<TKey,TValue>(IComparer<TKey>) SortedList<TKey,TValue>(IComparer<TKey>) SortedList<TKey,TValue>(IComparer<TKey>) SortedList<TKey,TValue>(IComparer<TKey>)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza la interfaz IComparer<T> especificada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the default initial capacity, and uses the specified IComparer<T>.

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

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que contiene elementos copiados de la interfaz IDictionary<TKey,TValue> especificada, tiene una capacidad suficiente para alojar el número de elementos copiados y utiliza la interfaz IComparer<T> predeterminada.Initializes a new instance of the SortedList<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue>, has sufficient capacity to accommodate the number of elements copied, and uses the default IComparer<T>.

SortedList<TKey,TValue>(Int32) SortedList<TKey,TValue>(Int32) SortedList<TKey,TValue>(Int32) SortedList<TKey,TValue>(Int32)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza la interfaz IComparer<T> predeterminada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the specified initial capacity, and uses the default IComparer<T>.

SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que contiene elementos copiados de la interfaz IDictionary<TKey,TValue> especificada, tiene una capacidad suficiente para alojar el número de elementos copiados y utiliza la interfaz IComparer<T> concretada.Initializes a new instance of the SortedList<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue>, has sufficient capacity to accommodate the number of elements copied, and uses the specified IComparer<T>.

SortedList<TKey,TValue>(Int32, IComparer<TKey>) SortedList<TKey,TValue>(Int32, IComparer<TKey>) SortedList<TKey,TValue>(Int32, IComparer<TKey>) SortedList<TKey,TValue>(Int32, IComparer<TKey>)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza la interfaz IComparer<T> especificada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the specified initial capacity, and uses the specified IComparer<T>.

SortedList<TKey,TValue>() SortedList<TKey,TValue>() SortedList<TKey,TValue>()

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza la interfaz IComparer<T> predeterminada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the default initial capacity, and uses the default IComparer<T>.

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

Ejemplos

En el ejemplo de código siguiente se SortedList<TKey,TValue> crea un vacío de cadenas con claves de Add cadena y se usa el método para agregar algunos elementos.The following code example creates an empty SortedList<TKey,TValue> of strings with string keys and uses the Add method to add some elements. En el ejemplo se muestra Add que el método produce ArgumentException una excepción al intentar agregar una clave duplicada.The example demonstrates that the Add method throws an ArgumentException when attempting to add a duplicate key.

Este ejemplo de código forma parte de un ejemplo más extenso proporcionado SortedList<TKey,TValue> para la clase.This code example is part of a larger example provided for the SortedList<TKey,TValue> class.

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

// Add some elements to the list. 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 list.
try
{
    openWith->Add("txt", "winword.exe");
}
catch (ArgumentException^)
{
    Console::WriteLine("An element with Key = \"txt\" already exists.");
}
// Create a new sorted list of strings, with string
// keys.
SortedList<string, string> openWith = 
    new SortedList<string, string>();

// Add some elements to the list. 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 list.
try
{
    openWith.Add("txt", "winword.exe");
}
catch (ArgumentException)
{
    Console.WriteLine("An element with Key = \"txt\" already exists.");
}
' Create a new sorted list of strings, with string 
' keys. 
Dim openWith As New SortedList(Of String, String)

' Add some elements to the list. 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 list.
Try
    openWith.Add("txt", "winword.exe")
Catch 
    Console.WriteLine("An element with Key = ""txt"" already exists.")
End Try

Comentarios

Cada clave de un SortedList<TKey,TValue> debe ser única según el comparador predeterminado.Every key in a SortedList<TKey,TValue> must be unique according to the default comparer.

Este constructor usa el valor predeterminado para la capacidad inicial de SortedList<TKey,TValue>.This constructor uses the default value for the initial capacity of the SortedList<TKey,TValue>. Para establecer la capacidad inicial, use el SortedList<TKey,TValue>(Int32) constructor.To set the initial capacity, use the SortedList<TKey,TValue>(Int32) constructor. Si se puede calcular el tamaño final de la colección, al especificar la capacidad inicial, se elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al SortedList<TKey,TValue>agregar elementos a.If the final size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the SortedList<TKey,TValue>.

Este constructor utiliza el comparador predeterminado TKeypara.This constructor uses the default comparer for TKey. Para especificar un comparador, utilice SortedList<TKey,TValue>(IComparer<TKey>) el constructor.To specify a comparer, use the SortedList<TKey,TValue>(IComparer<TKey>) constructor. El comparador Comparer<T>.Default predeterminado comprueba si el tipo TKey de clave System.IComparable<T> implementa y utiliza esa implementación, si está disponible.The default comparer Comparer<T>.Default checks whether the key type TKey implements System.IComparable<T> and uses that implementation, if available. Si no es Comparer<T>.Default así, comprueba si el TKey tipo de System.IComparableclave implementa.If not, Comparer<T>.Default checks whether the key type TKey implements System.IComparable. Si el tipo TKey de clave no implementa ninguna de las interfaces, puede especificar System.Collections.Generic.IComparer<T> una implementación en una sobrecarga del constructor que comparer acepte un parámetro.If the key type TKey does not implement either interface, you can specify a System.Collections.Generic.IComparer<T> implementation in a constructor overload that accepts a comparer parameter.

Este constructor es una operación O (1).This constructor is an O(1) operation.

Consulte también:

SortedList<TKey,TValue>(IComparer<TKey>) SortedList<TKey,TValue>(IComparer<TKey>) SortedList<TKey,TValue>(IComparer<TKey>) SortedList<TKey,TValue>(IComparer<TKey>)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial predeterminada y utiliza la interfaz IComparer<T> especificada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the default initial capacity, and uses the specified IComparer<T>.

public:
 SortedList(System::Collections::Generic::IComparer<TKey> ^ comparer);
public SortedList (System.Collections.Generic.IComparer<TKey> comparer);
new System.Collections.Generic.SortedList<'Key, 'Value> : System.Collections.Generic.IComparer<'Key> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (comparer As IComparer(Of TKey))

Parámetros

comparer
IComparer<TKey>

Implementación de IComparer<T> que se va a usar al comparar claves.The IComparer<T> implementation to use when comparing keys.

o bien-or- null para utilizar el objeto Comparer<T> predeterminado para el tipo de la clave.null to use the default Comparer<T> for the type of the key.

Ejemplos

En el ejemplo de código siguiente se crea una lista ordenada con un comparador que no distingue mayúsculas de minúsculas para la referencia cultural actual.The following code example creates a sorted list with a case-insensitive comparer for the current culture. En el ejemplo se agregan cuatro elementos, algunos con claves en minúsculas y otros con claves en mayúsculas.The example adds four elements, some with lower-case keys and some with upper-case keys. A continuación, en el ejemplo se intenta agregar un elemento con una clave que difiere de una clave existente solo por el uso de mayúsculas y minúsculas, detecta la excepción resultante y muestra un mensaje de error.The example then attempts to add an element with a key that differs from an existing key only by case, catches the resulting exception, and displays an error message. Por último, en el ejemplo se muestran los elementos en el criterio de ordenación que no distingue entre mayúsculas y minúsculas.Finally, the example displays the elements in case-insensitive sort order.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys and
        // a case-insensitive comparer for the current culture.
        SortedList<string, string> openWith = 
                      new SortedList<string, string>( 
                          StringComparer.CurrentCultureIgnoreCase);
        
        // Add some elements to the list. 
        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 sorted list.");
        }
        
        // List the contents of the sorted list.
        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 sorted list.

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 list of strings, with string keys and
        ' a case-insensitive comparer for the current culture.
        Dim openWith As New SortedList(Of String, String)( _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add some elements to the list. 
        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 sorted list.")
        End Try
        
        ' List the contents of the sorted list.
        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 sorted list.
'
'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 SortedList<TKey,TValue> debe ser única según el comparador especificado.Every key in a SortedList<TKey,TValue> must be unique according to the specified comparer.

Este constructor usa el valor predeterminado para la capacidad inicial de SortedList<TKey,TValue>.This constructor uses the default value for the initial capacity of the SortedList<TKey,TValue>. Para establecer la capacidad inicial, use el SortedList<TKey,TValue>(Int32, IComparer<TKey>) constructor.To set the initial capacity, use the SortedList<TKey,TValue>(Int32, IComparer<TKey>) constructor. Si se puede calcular el tamaño final de la colección, al especificar la capacidad inicial, se elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al SortedList<TKey,TValue>agregar elementos a.If the final size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the SortedList<TKey,TValue>.

Este constructor es una operación O (1).This constructor is an O(1) operation.

Consulte también:

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

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que contiene elementos copiados de la interfaz IDictionary<TKey,TValue> especificada, tiene una capacidad suficiente para alojar el número de elementos copiados y utiliza la interfaz IComparer<T> predeterminada.Initializes a new instance of the SortedList<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue>, has sufficient capacity to accommodate the number of elements copied, and uses the default IComparer<T>.

public:
 SortedList(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary);
public SortedList (System.Collections.Generic.IDictionary<TKey,TValue> dictionary);
new System.Collections.Generic.SortedList<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (dictionary As IDictionary(Of TKey, TValue))

Parámetros

Excepciones

dictionary contiene una o varias claves duplicadas.dictionary contains one or more duplicate keys.

Ejemplos

En el ejemplo de código siguiente se muestra SortedList<TKey,TValue> cómo usar para crear una copia ordenada de la información en Dictionary<TKey,TValue>un, pasando Dictionary<TKey,TValue> al SortedList<TKey,TValue>(IDictionary<TKey,TValue>) constructor.The following code example shows how to use SortedList<TKey,TValue> to create a sorted copy of the information in a Dictionary<TKey,TValue>, by passing the Dictionary<TKey,TValue> to the SortedList<TKey,TValue>(IDictionary<TKey,TValue>) constructor.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new Dictionary of strings, with string keys.
        //
        Dictionary<string, string> openWith = 
                                  new Dictionary<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 SortedList of strings with string keys, 
        // and initialize it with the contents of the Dictionary.
        SortedList<string, string> copy = 
                  new SortedList<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 Dictionary of strings, with string 
        ' keys.
        Dim openWith As New Dictionary(Of 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 SortedList of strings with string keys, 
        ' and initialize it with the contents of the Dictionary.
        Dim copy As New SortedList(Of String, String)(openWith)

        ' List the sorted 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 SortedList<TKey,TValue> debe ser única según el comparador predeterminado; igualmente, cada clave del origen dictionary también debe ser única según el comparador predeterminado.Every key in a SortedList<TKey,TValue> must be unique according to the default comparer; likewise, every key in the source dictionary must also be unique according to the default comparer.

La capacidad del nuevo SortedList<TKey,TValue> se establece en el número de elementos de dictionary, por lo que no se realiza ningún cambio de tamaño mientras se rellena la lista.The capacity of the new SortedList<TKey,TValue> is set to the number of elements in dictionary, so no resizing takes place while the list is being populated.

Este constructor utiliza el comparador predeterminado TKeypara.This constructor uses the default comparer for TKey. Para especificar un comparador, utilice SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) el constructor.To specify a comparer, use the SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) constructor. El comparador Comparer<T>.Default predeterminado comprueba si el tipo TKey de clave System.IComparable<T> implementa y utiliza esa implementación, si está disponible.The default comparer Comparer<T>.Default checks whether the key type TKey implements System.IComparable<T> and uses that implementation, if available. Si no es Comparer<T>.Default así, comprueba si el TKey tipo de System.IComparableclave implementa.If not, Comparer<T>.Default checks whether the key type TKey implements System.IComparable. Si el tipo TKey de clave no implementa ninguna de las interfaces, puede especificar System.Collections.Generic.IComparer<T> una implementación en una sobrecarga del constructor que comparer acepte un parámetro.If the key type TKey does not implement either interface, you can specify a System.Collections.Generic.IComparer<T> implementation in a constructor overload that accepts a comparer parameter.

Si se ordenan dictionary los datos de, este constructor es una operación On(), donde n es el número de elementos de dictionary.If the data in dictionary are sorted, this constructor is an O(n) operation, where n is the number of elements in dictionary. En caso contrario, es unanoperación O (*n).Otherwise it is an O(n*n) operation.

Consulte también:

SortedList<TKey,TValue>(Int32) SortedList<TKey,TValue>(Int32) SortedList<TKey,TValue>(Int32) SortedList<TKey,TValue>(Int32)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza la interfaz IComparer<T> predeterminada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the specified initial capacity, and uses the default IComparer<T>.

public:
 SortedList(int capacity);
public SortedList (int capacity);
new System.Collections.Generic.SortedList<'Key, 'Value> : int -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (capacity As Integer)

Parámetros

capacity
Int32 Int32 Int32 Int32

Número inicial de elementos que puede contener la colección SortedList<TKey,TValue>.The initial number of elements that the SortedList<TKey,TValue> can contain.

Excepciones

Ejemplos

En el ejemplo de código siguiente se crea una lista ordenada con una capacidad inicial de 4 y se rellena con 4 entradas.The following code example creates a sorted list with an initial capacity of 4 and populates it with 4 entries.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys and
        // an initial capacity of 4.
        SortedList<string, string> openWith = 
                               new SortedList<string, string>(4);
        
        // Add 4 elements to the list. 
        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 sorted list.
        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 = 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 list of strings, with string keys and
        ' an initial capacity of 4.
        Dim openWith As New SortedList(Of String, String)(4)
        
        ' Add 4 elements to the list. 
        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 sorted list.
        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 = bmp, Value = paint.exe
'Key = dib, Value = paint.exe
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe

Comentarios

Cada clave de un SortedList<TKey,TValue> debe ser única según el comparador predeterminado.Every key in a SortedList<TKey,TValue> must be unique according to the default comparer.

La capacidad de SortedList<TKey,TValue> es el número de elementos SortedList<TKey,TValue> que puede contener antes de cambiar el tamaño.The capacity of a SortedList<TKey,TValue> is the number of elements that the SortedList<TKey,TValue> can hold before resizing. A medida que se agregan SortedList<TKey,TValue>elementos a una, la capacidad aumenta automáticamente según sea necesario reasignando la matriz interna.As elements are added to a SortedList<TKey,TValue>, the capacity is automatically increased as required by reallocating the internal array.

Si se puede calcular el tamaño de la colección, al especificar la capacidad inicial, se elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al SortedList<TKey,TValue>agregar elementos a.If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the SortedList<TKey,TValue>.

La capacidad se puede reducir llamando a TrimExcess o estableciendo la Capacity propiedad explícitamente.The capacity can be decreased by calling TrimExcess or by setting the Capacity property explicitly. Al reducir la capacidad, se reasigna la memoria y se copian todos SortedList<TKey,TValue>los elementos de.Decreasing the capacity reallocates memory and copies all the elements in the SortedList<TKey,TValue>.

Este constructor utiliza el comparador predeterminado TKeypara.This constructor uses the default comparer for TKey. Para especificar un comparador, utilice SortedList<TKey,TValue>(Int32, IComparer<TKey>) el constructor.To specify a comparer, use the SortedList<TKey,TValue>(Int32, IComparer<TKey>) constructor. El comparador Comparer<T>.Default predeterminado comprueba si el tipo TKey de clave System.IComparable<T> implementa y utiliza esa implementación, si está disponible.The default comparer Comparer<T>.Default checks whether the key type TKey implements System.IComparable<T> and uses that implementation, if available. Si no es Comparer<T>.Default así, comprueba si el TKey tipo de System.IComparableclave implementa.If not, Comparer<T>.Default checks whether the key type TKey implements System.IComparable. Si el tipo TKey de clave no implementa ninguna de las interfaces, puede especificar System.Collections.Generic.IComparer<T> una implementación en una sobrecarga del constructor que comparer acepte un parámetro.If the key type TKey does not implement either interface, you can specify a System.Collections.Generic.IComparer<T> implementation in a constructor overload that accepts a comparer parameter.

Este constructor es una operación On(), donde n es capacity.This constructor is an O(n) operation, where n is capacity.

Consulte también:

SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que contiene elementos copiados de la interfaz IDictionary<TKey,TValue> especificada, tiene una capacidad suficiente para alojar el número de elementos copiados y utiliza la interfaz IComparer<T> concretada.Initializes a new instance of the SortedList<TKey,TValue> class that contains elements copied from the specified IDictionary<TKey,TValue>, has sufficient capacity to accommodate the number of elements copied, and uses the specified IComparer<T>.

public:
 SortedList(System::Collections::Generic::IDictionary<TKey, TValue> ^ dictionary, System::Collections::Generic::IComparer<TKey> ^ comparer);
public SortedList (System.Collections.Generic.IDictionary<TKey,TValue> dictionary, System.Collections.Generic.IComparer<TKey> comparer);
new System.Collections.Generic.SortedList<'Key, 'Value> : System.Collections.Generic.IDictionary<'Key, 'Value> * System.Collections.Generic.IComparer<'Key> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (dictionary As IDictionary(Of TKey, TValue), comparer As IComparer(Of TKey))

Parámetros

comparer
IComparer<TKey>

Implementación de IComparer<T> que se va a usar al comparar claves.The IComparer<T> implementation to use when comparing keys.

O bien-or- null para utilizar el objeto Comparer<T> predeterminado para el tipo de la clave.null to use the default Comparer<T> for the type of the key.

Excepciones

dictionary contiene una o varias claves duplicadas.dictionary contains one or more duplicate keys.

Ejemplos

En el ejemplo de código siguiente se muestra SortedList<TKey,TValue> cómo usar para crear una copia ordenada sin distinción de mayúsculas y minúsculas de la información en Dictionary<TKey,TValue>una sin distinción de Dictionary<TKey,TValue> mayúsculas SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) y minúsculas, pasando al constructor.The following code example shows how to use SortedList<TKey,TValue> to create a case-insensitive sorted copy of the information in a case-insensitive Dictionary<TKey,TValue>, by passing the Dictionary<TKey,TValue> to the SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) constructor. En este ejemplo, los comparadores que no distinguen mayúsculas de minúsculas son para la referencia cultural actual.In this example, the case-insensitive comparers are for the current culture.

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 equality 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");
        
        // Create a SortedList of strings with string keys and a 
        // case-insensitive equality comparer for the current culture,
        // and initialize it with the contents of the Dictionary.
        SortedList<string, string> copy = 
            new SortedList<string, string>(openWith, 
                StringComparer.CurrentCultureIgnoreCase);

        // List the sorted 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 Dictionary of strings, with string keys and
        ' a case-insensitive equality 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")
        
        ' Create a SortedList of strings with string keys and a 
        ' case-insensitive equality comparer for the current culture,
        ' and initialize it with the contents of the Dictionary.
        Dim copy As New SortedList(Of String, String)(openWith, _
            StringComparer.CurrentCultureIgnoreCase)

        ' List the sorted 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 SortedList<TKey,TValue> debe ser única según el comparador especificado; igualmente, cada clave del origen dictionary también debe ser única según el comparador especificado.Every key in a SortedList<TKey,TValue> must be unique according to the specified comparer; likewise, every key in the source dictionary must also be unique according to the specified comparer.

La capacidad del nuevo SortedList<TKey,TValue> se establece en el número de elementos de dictionary, por lo que no se realiza ningún cambio de tamaño mientras se rellena la lista.The capacity of the new SortedList<TKey,TValue> is set to the number of elements in dictionary, so no resizing takes place while the list is being populated.

Si se ordenan dictionary los datos de, este constructor es una operación On(), donde n es el número de elementos de dictionary.If the data in dictionary are sorted, this constructor is an O(n) operation, where n is the number of elements in dictionary. En caso contrario, es unanoperación O (*n).Otherwise it is an O(n*n) operation.

Consulte también:

SortedList<TKey,TValue>(Int32, IComparer<TKey>) SortedList<TKey,TValue>(Int32, IComparer<TKey>) SortedList<TKey,TValue>(Int32, IComparer<TKey>) SortedList<TKey,TValue>(Int32, IComparer<TKey>)

Inicializa una nueva instancia de la clase SortedList<TKey,TValue> que está vacía, tiene la capacidad inicial especificada y utiliza la interfaz IComparer<T> especificada.Initializes a new instance of the SortedList<TKey,TValue> class that is empty, has the specified initial capacity, and uses the specified IComparer<T>.

public:
 SortedList(int capacity, System::Collections::Generic::IComparer<TKey> ^ comparer);
public SortedList (int capacity, System.Collections.Generic.IComparer<TKey> comparer);
new System.Collections.Generic.SortedList<'Key, 'Value> : int * System.Collections.Generic.IComparer<'Key> -> System.Collections.Generic.SortedList<'Key, 'Value>
Public Sub New (capacity As Integer, comparer As IComparer(Of TKey))

Parámetros

capacity
Int32 Int32 Int32 Int32

Número inicial de elementos que puede contener la colección SortedList<TKey,TValue>.The initial number of elements that the SortedList<TKey,TValue> can contain.

comparer
IComparer<TKey>

Implementación de IComparer<T> que se va a usar al comparar claves.The IComparer<T> implementation to use when comparing keys.

o bien-or- null para utilizar el objeto Comparer<T> predeterminado para el tipo de la clave.null to use the default Comparer<T> for the type of the key.

Excepciones

Ejemplos

En el ejemplo de código siguiente se crea una lista ordenada con una capacidad inicial de 5 y un comparador sin distinción entre mayúsculas y minúsculas para la referencia cultural actual.The following code example creates a sorted list with an initial capacity of 5 and a case-insensitive comparer for the current culture. En el ejemplo se agregan cuatro elementos, algunos con claves en minúsculas y otros con claves en mayúsculas.The example adds four elements, some with lower-case keys and some with upper-case keys. A continuación, en el ejemplo se intenta agregar un elemento con una clave que difiere de una clave existente solo por el uso de mayúsculas y minúsculas, detecta la excepción resultante y muestra un mensaje de error.The example then attempts to add an element with a key that differs from an existing key only by case, catches the resulting exception, and displays an error message. Por último, en el ejemplo se muestran los elementos en el criterio de ordenación que no distingue entre mayúsculas y minúsculas.Finally, the example displays the elements in case-insensitive sort order.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create a new sorted list of strings, with string keys, an
        // initial capacity of 5, and a case-insensitive comparer.
        SortedList<string, string> openWith = 
                      new SortedList<string, string>(5, 
                          StringComparer.CurrentCultureIgnoreCase);
        
        // Add 4 elements to the list. 
        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 sorted list.");
        }
        
        // List the contents of the sorted list.
        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 sorted list.

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 list of strings, with string keys, an
        ' initial capacity of 5, and a case-insensitive comparer.
        Dim openWith As New SortedList(Of String, String)(5, _
            StringComparer.CurrentCultureIgnoreCase)
        
        ' Add 4 elements to the list. 
        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 sorted list.")
        End Try
        
        ' List the contents of the sorted list.
        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 sorted list.
'
'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 SortedList<TKey,TValue> debe ser única según el comparador especificado.Every key in a SortedList<TKey,TValue> must be unique according to the specified comparer.

La capacidad de SortedList<TKey,TValue> es el número de elementos SortedList<TKey,TValue> que puede contener antes de cambiar el tamaño.The capacity of a SortedList<TKey,TValue> is the number of elements that the SortedList<TKey,TValue> can hold before resizing. A medida que se agregan SortedList<TKey,TValue>elementos a una, la capacidad aumenta automáticamente según sea necesario reasignando la matriz interna.As elements are added to a SortedList<TKey,TValue>, the capacity is automatically increased as required by reallocating the internal array.

Si se puede calcular el tamaño de la colección, al especificar la capacidad inicial, se elimina la necesidad de realizar una serie de operaciones de cambio de tamaño al SortedList<TKey,TValue>agregar elementos a.If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the SortedList<TKey,TValue>.

La capacidad se puede reducir llamando a TrimExcess o estableciendo la Capacity propiedad explícitamente.The capacity can be decreased by calling TrimExcess or by setting the Capacity property explicitly. Al reducir la capacidad, se reasigna la memoria y se copian todos SortedList<TKey,TValue>los elementos de.Decreasing the capacity reallocates memory and copies all the elements in the SortedList<TKey,TValue>.

Este constructor es una operación On(), donde n es capacity.This constructor is an O(n) operation, where n is capacity.

Consulte también:

Se aplica a