SortedList.Item[Object] Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o valor associado a uma chave específica num SortedList objeto.
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, setDefault Public Overridable Property Item(key As Object) As ObjectParâmetros
- key
- Object
A chave associada ao valor a obter ou definir.
Valor de Propriedade
O valor associado ao key parâmetro no SortedList objeto, se key for encontrado; caso contrário, null.
Implementações
Exceções
key é null.
A propriedade é definida e o SortedList objeto é apenas leitura.
-ou-
A propriedade é definida, key não existe na coleção, e tem SortedList um tamanho fixo.
Não há memória suficiente disponível para adicionar o elemento ao SortedList.
O comparador lança uma exceção.
Observações
Pode usar a Item[] propriedade para aceder a um elemento específico numa coleção especificando a seguinte sintaxe: myCollection[key].
Também pode usar esta 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 SortedList, definindo a Item[] propriedade sobrescreve o valor antigo. Em contraste, 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 isso é devolvido porque a chave especificada não é encontrada e null este é devolvido 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 a SortedList são ordenados pelas chaves, seja de acordo com uma implementação específica IComparer especificada quando o SortedList é criado, quer de acordo com a IComparable implementação fornecida pelas próprias chaves.
A linguagem C# usa a this palavra-chave para definir os indexadores em vez de implementar a propriedade Keys . Visual Basic implementa Item[] como propriedade predefinida, que fornece a mesma funcionalidade de indexação.
Recuperar o valor desta propriedade é uma O(log n) operação, onde n é Count. Definir a propriedade é uma O(log n) operação se a chave já estiver no SortedList. Se a chave não estiver na lista, definir a propriedade é uma O(n) operação para dados não ordenados, ou O(log n) se o novo elemento for adicionado no final da lista. Se a inserção causar um redimensionamento, a operação é O(n).