Hashtable.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 à chave especificada.
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 cujo valor deve ser obtido ou definido.
Valor de Propriedade
O valor associado à chave especificada. Se a chave especificada não for encontrada, tentar obtê-la retorna null, e tentar defini-la cria um novo elemento usando a chave especificada.
Implementações
Exceções
key é null.
A propriedade está definida e a Hashtable é apenas leitura.
-ou-
A propriedade é definida, key não existe na coleção, e tem Hashtable um tamanho fixo.
Observações
Esta propriedade permite aceder a um elemento específico da coleção utilizando a seguinte sintaxe: myCollection[key].
Também pode usar a Item[] propriedade para adicionar novos elementos definindo o valor de uma chave que não existe no Hashtable; por exemplo, myCollection["myNonexistentKey"] = myValue. No entanto, se a chave especificada já existir no Hashtable, 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.
Recuperar o valor desta propriedade é uma O(1) operação; definir a propriedade também é uma O(1) operação.
A linguagem C# usa a this palavra-chave para definir os indexadores em vez de implementar a propriedade Item[] . Visual Basic implementa Item[] como propriedade predefinida, que fornece a mesma funcionalidade de indexação.