SortedList<TKey,TValue> Construtores

Definição

Inicializa uma nova instância da classe SortedList<TKey,TValue>.

Sobrecargas

SortedList<TKey,TValue>()

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial padrão e usa o IComparer<T> padrão.

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

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial padrão e usa o IComparer<T> especificado.

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

Inicializa uma nova instância da classe SortedList<TKey,TValue> que contém elementos copiados do IDictionary<TKey,TValue> especificado, tem capacidade suficiente para acomodar o número de elementos copiados e usa o IComparer<T> padrão.

SortedList<TKey,TValue>(Int32)

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial especificada e usa o IComparer<T> padrão.

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

Inicializa uma nova instância da classe SortedList<TKey,TValue>, que contém os elementos copiados do IDictionary<TKey,TValue> especificado, tem capacidade suficiente para acomodar o número de elementos copiados e usa o IComparer<T> especificado.

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

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial especificada e usa o IComparer<T> especificado.

SortedList<TKey,TValue>()

Origem:
SortedList.cs
Origem:
SortedList.cs
Origem:
SortedList.cs

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial padrão e usa o IComparer<T> padrão.

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

Exemplos

O exemplo de código a seguir cria um vazio SortedList<TKey,TValue> de cadeias de caracteres com chaves de cadeia de caracteres e usa o Add método para adicionar alguns elementos. O exemplo demonstra que o Add método lança um ArgumentException ao tentar adicionar uma chave duplicada.

Este exemplo de código faz parte de um exemplo maior fornecido para a SortedList<TKey,TValue> classe .

// 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
// Create a new sorted list of strings, with string
// keys.
let openWith = 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");
with
    | :? ArgumentException ->
        printfn "An element with Key = \"txt\" already exists."

Comentários

Cada chave em um SortedList<TKey,TValue> deve ser exclusiva de acordo com o comparador padrão.

Esse construtor usa o valor padrão para a capacidade inicial do SortedList<TKey,TValue>. Para definir a capacidade inicial, use o SortedList<TKey,TValue>(Int32) construtor . Se o tamanho final da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao SortedList<TKey,TValue>.

Esse construtor usa o comparador padrão para TKey. Para especificar um comparador, use o SortedList<TKey,TValue>(IComparer<TKey>) construtor . O comparador Comparer<T>.Default padrão verifica se o tipo TKey de chave implementa System.IComparable<T> e usa essa implementação, se disponível. Caso contrário, Comparer<T>.Default verifica se o tipo TKey de chave implementa System.IComparable. Se o tipo TKey de chave não implementar nenhuma das interfaces, você poderá especificar uma System.Collections.Generic.IComparer<T> implementação em uma sobrecarga de construtor que aceite um comparer parâmetro.

Este construtor é uma operação O(1).

Confira também

Aplica-se a

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

Origem:
SortedList.cs
Origem:
SortedList.cs
Origem:
SortedList.cs

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial padrão e usa o IComparer<T> especificado.

public:
 SortedList(System::Collections::Generic::IComparer<TKey> ^ comparer);
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>

A implementação de IComparer<T> a ser usada ao comparar chaves.

- ou -

O null a se usar o padrão Comparer<T> para o tipo da chave.

Exemplos

O exemplo de código a seguir cria uma lista classificada com um comparador que não diferencia maiúsculas de minúsculas para a cultura atual. O exemplo adiciona quatro elementos, alguns com teclas minúsculas e alguns com teclas maiúsculas. Em seguida, o exemplo tenta adicionar um elemento com uma chave que difere de uma chave existente apenas por caso, captura a exceção resultante e exibe uma mensagem de erro. Por fim, o exemplo exibe os elementos na ordem de classificação que não diferencia maiúsculas de minúsculas.

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

Comentários

Cada chave em um SortedList<TKey,TValue> deve ser exclusiva de acordo com o comparador especificado.

Esse construtor usa o valor padrão para a capacidade inicial do SortedList<TKey,TValue>. Para definir a capacidade inicial, use o SortedList<TKey,TValue>(Int32, IComparer<TKey>) construtor . Se o tamanho final da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao SortedList<TKey,TValue>.

Este construtor é uma operação O(1).

Confira também

Aplica-se a

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

Origem:
SortedList.cs
Origem:
SortedList.cs
Origem:
SortedList.cs

Inicializa uma nova instância da classe SortedList<TKey,TValue> que contém elementos copiados do IDictionary<TKey,TValue> especificado, tem capacidade suficiente para acomodar o número de elementos copiados e usa o IComparer<T> padrão.

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

dictionary
IDictionary<TKey,TValue>

O IDictionary<TKey,TValue> cujos elementos são copiados para o novo SortedList<TKey,TValue>.

Exceções

dictionary é null.

dictionary contém uma ou mais chaves duplicadas.

Exemplos

O exemplo de código a seguir mostra como usar SortedList<TKey,TValue> para criar uma cópia classificada das informações em um Dictionary<TKey,TValue>, passando o Dictionary<TKey,TValue> para o SortedList<TKey,TValue>(IDictionary<TKey,TValue>) construtor.

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

Comentários

Cada chave em um SortedList<TKey,TValue> deve ser exclusiva de acordo com o comparador padrão; da mesma forma, cada chave na origem dictionary também deve ser exclusiva de acordo com o comparador padrão.

A capacidade do novo SortedList<TKey,TValue> é definida como o número de elementos em dictionary, portanto, nenhum redimensionamento ocorre enquanto a lista está sendo preenchida.

Esse construtor usa o comparador padrão para TKey. Para especificar um comparador, use o SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) construtor . O comparador Comparer<T>.Default padrão verifica se o tipo TKey de chave implementa System.IComparable<T> e usa essa implementação, se disponível. Caso contrário, Comparer<T>.Default verifica se o tipo TKey de chave implementa System.IComparable. Se o tipo TKey de chave não implementar nenhuma das interfaces, você poderá especificar uma System.Collections.Generic.IComparer<T> implementação em uma sobrecarga de construtor que aceite um comparer parâmetro.

As chaves em dictionary são copiadas para o novo SortedList<TKey,TValue> e classificado uma vez, o que torna esse construtor uma operação O(n log n).

Confira também

Aplica-se a

SortedList<TKey,TValue>(Int32)

Origem:
SortedList.cs
Origem:
SortedList.cs
Origem:
SortedList.cs

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial especificada e usa o IComparer<T> padrão.

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

O número inicial de elementos que o SortedList<TKey,TValue> pode conter.

Exceções

capacity é menor que zero.

Exemplos

O exemplo de código a seguir cria uma lista classificada com uma capacidade inicial de 4 e a preenche com 4 entradas.

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

Comentários

Cada chave em um SortedList<TKey,TValue> deve ser exclusiva de acordo com o comparador padrão.

A capacidade de um SortedList<TKey,TValue> é o número de elementos que o SortedList<TKey,TValue> pode conter antes do redimensionamento. À medida que os elementos são adicionados a um SortedList<TKey,TValue>, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao SortedList<TKey,TValue>.

A capacidade pode ser reduzida chamando TrimExcess ou definindo a Capacity propriedade explicitamente. Diminuir a capacidade realoca a memória e copia todos os elementos no SortedList<TKey,TValue>.

Esse construtor usa o comparador padrão para TKey. Para especificar um comparador, use o SortedList<TKey,TValue>(Int32, IComparer<TKey>) construtor . O comparador Comparer<T>.Default padrão verifica se o tipo TKey de chave implementa System.IComparable<T> e usa essa implementação, se disponível. Caso contrário, Comparer<T>.Default verifica se o tipo TKey de chave implementa System.IComparable. Se o tipo TKey de chave não implementar nenhuma das interfaces, você poderá especificar uma System.Collections.Generic.IComparer<T> implementação em uma sobrecarga de construtor que aceite um comparer parâmetro.

Esse construtor é uma operação O(n), em que n é capacity.

Confira também

Aplica-se a

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

Origem:
SortedList.cs
Origem:
SortedList.cs
Origem:
SortedList.cs

Inicializa uma nova instância da classe SortedList<TKey,TValue>, que contém os elementos copiados do IDictionary<TKey,TValue> especificado, tem capacidade suficiente para acomodar o número de elementos copiados e usa o IComparer<T> especificado.

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

dictionary
IDictionary<TKey,TValue>

O IDictionary<TKey,TValue> cujos elementos são copiados para o novo SortedList<TKey,TValue>.

comparer
IComparer<TKey>

A implementação de IComparer<T> a ser usada ao comparar chaves.

- ou -

O null a se usar o padrão Comparer<T> para o tipo da chave.

Exceções

dictionary é null.

dictionary contém uma ou mais chaves duplicadas.

Exemplos

O exemplo de código a seguir mostra como usar SortedList<TKey,TValue> para criar uma cópia classificada que não diferencia maiúsculas de minúsculas das informações em um que não diferencia Dictionary<TKey,TValue>maiúsculas de minúsculas, passando o Dictionary<TKey,TValue> para o SortedList<TKey,TValue>(IDictionary<TKey,TValue>, IComparer<TKey>) construtor. Neste exemplo, os comparadores que não diferenciam maiúsculas de minúsculas são para a cultura atual.

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

Comentários

Cada chave em um SortedList<TKey,TValue> deve ser exclusiva de acordo com o comparador especificado; da mesma forma, cada chave na origem dictionary também deve ser exclusiva de acordo com o comparador especificado.

A capacidade do novo SortedList<TKey,TValue> é definida como o número de elementos em dictionary, portanto, nenhum redimensionamento ocorre enquanto a lista está sendo preenchida.

As chaves em dictionary são copiadas para o novo SortedList<TKey,TValue> e classificado uma vez, o que torna esse construtor uma operação O(n log n).

Confira também

Aplica-se a

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

Origem:
SortedList.cs
Origem:
SortedList.cs
Origem:
SortedList.cs

Inicializa uma nova instância da classe SortedList<TKey,TValue> que está vazia, tem a capacidade inicial especificada e usa o IComparer<T> especificado.

public:
 SortedList(int capacity, System::Collections::Generic::IComparer<TKey> ^ comparer);
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

O número inicial de elementos que o SortedList<TKey,TValue> pode conter.

comparer
IComparer<TKey>

A implementação de IComparer<T> a ser usada ao comparar chaves.

- ou -

O null a se usar o padrão Comparer<T> para o tipo da chave.

Exceções

capacity é menor que zero.

Exemplos

O exemplo de código a seguir cria uma lista classificada com uma capacidade inicial de 5 e um comparador que não diferencia maiúsculas de minúsculas para a cultura atual. O exemplo adiciona quatro elementos, alguns com teclas minúsculas e alguns com teclas maiúsculas. Em seguida, o exemplo tenta adicionar um elemento com uma chave que difere de uma chave existente apenas por caso, captura a exceção resultante e exibe uma mensagem de erro. Por fim, o exemplo exibe os elementos na ordem de classificação que não diferencia maiúsculas de minúsculas.

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

Comentários

Cada chave em um SortedList<TKey,TValue> deve ser exclusiva de acordo com o comparador especificado.

A capacidade de um SortedList<TKey,TValue> é o número de elementos que o SortedList<TKey,TValue> pode conter antes do redimensionamento. À medida que os elementos são adicionados a um SortedList<TKey,TValue>, a capacidade é automaticamente aumentada conforme exigido pela realocação da matriz interna.

Se o tamanho da coleção puder ser estimado, especificar a capacidade inicial eliminará a necessidade de executar várias operações de redimensionamento ao adicionar elementos ao SortedList<TKey,TValue>.

A capacidade pode ser reduzida chamando TrimExcess ou definindo a Capacity propriedade explicitamente. Diminuir a capacidade realoca a memória e copia todos os elementos no SortedList<TKey,TValue>.

Esse construtor é uma operação O(n), em que n é capacity.

Confira também

Aplica-se a