Hashtable.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 à 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 da propriedade
O valor associado à chave especificada. Se a chave especificada não for encontrada, tentar obtê-la retornará nulle tentar defini-la criará um novo elemento usando a chave especificada.
Implementações
Exceções
key é null.
A propriedade é definida e Hashtable é somente leitura.
-ou-
A propriedade é definida, key não existe na coleção e Hashtable tem um tamanho fixo.
Comentários
Essa propriedade fornece a capacidade de acessar um elemento específico na coleção usando a seguinte sintaxe: myCollection[key].
Você 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 , definir Hashtablea Item[] propriedade substituirá o valor antigo. Por outro lado, o Add método não modifica os elementos existentes.
Uma chave não pode ser null, mas um valor pode ser. Para distinguir entre null isso é retornado porque a chave especificada não foi encontrada e null 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.
Recuperar o valor dessa 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 Item[] propriedade. O Visual Basic implementa Item[] como uma propriedade padrão, que fornece a mesma funcionalidade de indexação.