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 ottenere o impostare il valore.
Valore della proprietà
Valore associato alla chiave specificata. Se la chiave specificata non viene trovata, il tentativo di ottenerlo restituisce nulle il tentativo di impostarlo crea un nuovo elemento usando la chiave specificata.
Implementazioni
Eccezioni
key è null.
La proprietà è impostata e è Hashtable di sola lettura.
oppure
La proprietà è impostata, key non esiste nell'insieme e ha Hashtable una dimensione fissa.
Commenti
Questa proprietà consente di accedere a un elemento specifico dell'insieme usando la sintassi seguente: myCollection[key].
È anche possibile utilizzare la Item[] proprietà per aggiungere nuovi elementi impostando il valore di una chiave che non esiste in Hashtable, ad esempio myCollection["myNonexistentKey"] = myValue. Tuttavia, se la chiave specificata esiste già in , l'impostazione Hashtabledella Item[] proprietà sovrascrive il 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 la chiave restituita perché la chiave specificata non viene trovata e null restituita perché il valore della chiave specificata è null, utilizzare il Contains metodo o il ContainsKey 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) .
Il linguaggio C# usa la this parola chiave per definire gli indicizzatori anziché implementare la Item[] proprietà . Visual Basic implementa Item[] come proprietà predefinita, che fornisce la stessa funzionalità di indicizzazione.
