SortedList.Item[Object] Propriedade

Definição

Obtém ou define o valor associado com uma chave específica em um objeto SortedList.Gets or sets the value associated with a specific key in a SortedList object.

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.The key associated with the value to get or set.

Valor da propriedade

O valor associado ao parâmetro key no objeto SortedList se key for localizado; caso contrário, null.The value associated with the key parameter in the SortedList object, if key is found; otherwise, null.

Implementações

Exceções

key é null.key is null.

A propriedade é definida e o objeto SortedList é somente leitura.The property is set and the SortedList object is read-only.

- ou --or- A propriedade é definida, key não existe na coleção e o SortedList tem um tamanho fixo.The property is set, key does not exist in the collection, and the SortedList has a fixed size.

Não há memória suficiente disponível para adicionar o elemento ao SortedList.There is not enough available memory to add the element to the SortedList.

O comparador gera uma exceção.The comparer throws an exception.

Comentários

Você pode usar a propriedade Item[Object] para acessar um elemento específico em uma coleção, especificando a seguinte sintaxe: myCollection[key].You can use the Item[Object] property to access a specific element in a collection by specifying the following syntax: myCollection[key].

Você também pode usar essa propriedade para adicionar novos elementos definindo o valor de uma chave que não existe no objeto SortedList (por exemplo, myCollection["myNonexistentKey"] = myValue).You can also use this property to add new elements by setting the value of a key that does not exist in the SortedList object (for example, myCollection["myNonexistentKey"] = myValue). No entanto, se a chave especificada já existir no SortedList, a definição da propriedade Item[Object] substituirá o valor antigo.However, if the specified key already exists in the SortedList, setting the Item[Object] property overwrites the old value. Por outro lado, o método Add não modifica os elementos existentes.In contrast, the Add method does not modify existing elements.

Uma chave não pode ser null, mas um valor pode ser.A key cannot be null, but a value can be. Para distinguir entre null retornado porque a chave especificada não foi encontrada e null retornada porque o valor da chave especificada é null, use o método Contains ou o método ContainsKey para determinar se a chave existe na lista.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

Os elementos de um SortedList são classificados pelas chaves de acordo com uma implementação específica de IComparer especificada quando o SortedList é criado ou de acordo com a implementação IComparable fornecida pelas próprias chaves.The elements of a SortedList are sorted by the keys either according to a specific IComparer implementation specified when the SortedList is created or according to the IComparable implementation provided by the keys themselves.

O C# idioma usa a palavra -chave this para definir os indexadores em vez de implementar a propriedade Keys.The C# language uses the this keyword to define the indexers instead of implementing the Keys property. Visual Basic implementa Item[Object] como uma propriedade padrão, que fornece a mesma funcionalidade de indexação.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

A recuperação do valor dessa propriedade é uma operação O(log n), em que n é Count.Retrieving the value of this property is an O(log n) operation, where n is Count. Definir a propriedade é uma operação O(log n) se a chave já estiver no SortedList.Setting the property is an O(log n) operation if the key is already in the SortedList. Se a chave não estiver na lista, definir a propriedade será uma operação O(n) para dados não classificados ou O(log n) se o novo elemento for adicionado ao final da lista.If the key is not in the list, setting the property is an O(n) operation for unsorted data, or O(log n) if the new element is added at the end of the list. Se a inserção causar um redimensionamento, a operação será O(n).If insertion causes a resize, the operation is O(n).

Aplica-se a

Veja também