Hashtable.Item[Object] Proprietà

Definizione

Spazio dei nomi:

System.Collections

Assembly:

System.Runtime.dll

Source:

Hashtable.cs

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; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

Parametri

key

Object

Chiave di cui si deve ottenere o impostare il valore.

Valore della proprietà

Object

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

Item[Object]

Eccezioni

ArgumentNullException

key è null.

NotSupportedException

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.

Vedi anche

• Add(Object, Object)