SortedList.Item[Object] Propriedade

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

SortedList.cs

Obtém ou define o valor associado com uma chave específica em um objeto SortedList.

public:
 virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public virtual object? this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

Parâmetros

key

Object

A chave associada com o valor a ser obtido ou definido.

Valor da propriedade

Object

O valor associado ao parâmetro key no objeto SortedList se key for localizado; caso contrário, null.

Implementações

Item[Object]

Exceções

ArgumentNullException

key é null.

NotSupportedException

A propriedade é definida e o objeto SortedList é somente leitura.

- ou -

A propriedade é definida, key não existe na coleção e o SortedList tem um tamanho fixo.

OutOfMemoryException

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

InvalidOperationException

O comparador gera uma exceção.

Comentários

Você pode usar a Item[] propriedade para acessar um elemento específico em uma coleção especificando a seguinte sintaxe: myCollection[key].

Você também pode usar essa 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 elementos existentes.

Uma chave não pode ser null, mas um valor pode ser. Para distinguir entre null o que é retornado porque a chave especificada não foi encontrada e null que é retornada porque o valor da chave especificada é null, use o Contains método ou o ContainsKey método para determinar se a chave existe na lista.

Os elementos de um SortedList 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.

A linguagem C# usa o this palavra-chave para definir os indexadores em vez de implementar a Keys propriedade . O Visual Basic implementa Item[] como uma propriedade padrão, que fornece a mesma funcionalidade de indexação.

Recuperar o valor dessa propriedade é uma O(log n) operação, em que n é Count. Definir a propriedade será uma O(log n) operação se a chave já estiver no SortedList. Se a chave não estiver na lista, definir a propriedade será uma O(n) operação para dados não classificados ou O(log n) se o novo elemento for adicionado no final da lista. Se a inserção causar um redimensionamento, a operação será O(n).

Confira também

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções