SortedList.Add(Object, Object) Método

Definição

Adiciona um elemento com a chave e o valor especificados a um objeto SortedList.

public virtual void Add (object key, object value);
public virtual void Add (object key, object? value);

Parâmetros

key
Object

A chave do elemento a ser adicionada.

value
Object

O valor do elemento a ser adicionado. O valor pode ser null.

Implementações

Exceções

key é null.

Já existe um elemento com o key especificado no objeto SortedList.

- ou -

O SortedList está definido para usar a interface IComparable e key não implementa a interface IComparable.

O SortedList é somente leitura.

- ou -

O SortedList tem um tamanho fixo.

Não há memória suficiente disponível para adicionar o elemento ao SortedList.

O comparador gera uma exceção.

Exemplos

O exemplo de código a seguir mostra como adicionar elementos a um SortedList objeto .

using System;
using System.Collections;
public class SamplesSortedList  {

   public static void Main()  {

      // Creates and initializes a new SortedList.
      SortedList mySL = new SortedList();
      mySL.Add( "one", "The" );
      mySL.Add( "two", "quick" );
      mySL.Add( "three", "brown" );
      mySL.Add( "four", "fox" );

      // Displays the SortedList.
      Console.WriteLine( "The SortedList contains the following:" );
      PrintKeysAndValues( mySL );
   }

   public static void PrintKeysAndValues( SortedList myList )  {
      Console.WriteLine( "\t-KEY-\t-VALUE-" );
      for ( int i = 0; i < myList.Count; i++ )  {
         Console.WriteLine( "\t{0}:\t{1}", myList.GetKey(i), myList.GetByIndex(i) );
      }
      Console.WriteLine();
   }
}
/*
This code produces the following output.

The SortedList contains the following:
    -KEY-    -VALUE-
    four:    fox
    one:    The
    three:    brown
    two:    quick
*/

Comentários

O ponto de inserção é determinado com base no comparador selecionado, explicitamente ou por padrão, quando o SortedList objeto foi criado.

Se Count já for igual Capacitya , a capacidade do SortedList objeto será aumentada realocando automaticamente a matriz interna e os elementos existentes serão copiados para a nova matriz antes que o novo elemento seja adicionado.

Você também pode usar a Item[] propriedade para adicionar novos elementos definindo o valor de uma chave que não existe no SortedList objeto (por exemplo, myCollection["myNonexistentKey"] = myValue). No entanto, se a chave especificada já existir no , definir SortedLista Item[] propriedade substituirá o valor antigo. Por outro lado, o Add método não modifica os elementos existentes.

Os elementos de um SortedList objeto são classificados pelas chaves de acordo com uma implementação específica IComparer especificada quando o SortedList é criado ou de acordo com a IComparable implementação fornecida pelas próprias chaves.

Uma chave não pode ser null, mas um valor pode ser.

Esse método é uma O(n) operação para dados não classificados, em que n é Count. Será uma O(log n) operação se o novo elemento for adicionado no final da lista. Se a inserção causar um redimensionamento, a operação será O(n).

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Confira também