SortedList.Item[Object] Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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; }public virtual object? this[object key] { get; set; }member this.Item(obj) : obj with get, setDefault Public Overridable Property Item(key As Object) As ObjectParâmetros
- key
- Object
A chave associada com o valor a ser obtido ou definido.
Valor da propriedade
O valor associado ao parâmetro key no objeto SortedList se key for localizado; caso contrário, null.
Implementações
Exceções
key é null.
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.
Não há memória suficiente disponível para adicionar o elemento ao SortedList.
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).
