Hashtable.Item[Object] Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il valore associato alla chiave specificata.
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 ObjectParametri
- key
- Object
Chiave di cui si deve ottenere o impostare il valore.
Valore della proprietà
Valore associato alla chiave specificata. Se la chiave specificata non viene trovata, tentando di ottenerla viene restituito null mentre tentando di impostarla viene creato un nuovo elemento con la chiave specificata.
Implementazioni
Eccezioni
key è null.
La proprietà è stata impostata e l'interfaccia Hashtable è in sola lettura.
-oppure-
La proprietà è impostata, key non esiste nella raccolta e Hashtable è di dimensioni fisse.
Commenti
Questa proprietà consente di accedere a un elemento specifico nella raccolta utilizzando la sintassi seguente: myCollection[key].
È anche possibile usare la Item[] proprietà per aggiungere nuovi elementi impostando il valore di una chiave che non esiste nell'oggetto Hashtable, ad esempio myCollection["myNonexistentKey"] = myValue. Tuttavia, se la chiave specificata esiste già nell'impostazione Hashtable, impostando la proprietà sovrascrive il Item[] valore precedente. Al contrario, il Add metodo non modifica gli elementi esistenti.
Una chiave non può essere null, ma un valore può essere. Per distinguere null tra quello restituito perché la chiave specificata non viene trovata e null restituita perché il valore della chiave specificata è null, utilizzare il metodo o ContainsKey il Contains metodo per determinare se la chiave esiste nell'elenco.
Il recupero del valore di questa proprietà è un'operazione O(1) . L'impostazione della proprietà è anche un'operazione O(1) .
Nel linguaggio C# viene utilizzata la parola chiave this per definire gli indicizzatori anziché implementare la proprietà Item[]. In Visual Basic la proprietà Item[] viene implementata come predefinita per fornire la stessa funzionalità di indicizzazione.
