Hashtable.Item[Object] Hashtable.Item[Object] Hashtable.Item[Object] Hashtable.Item[Object] Property

Definizione

Ottiene o imposta il valore associato alla chiave specificata.Gets or sets the value associated with the specified key.

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 Object Object Object

Chiave di cui si deve ottenere o impostare il valore.The key whose value to get or set.

Valore della proprietà

Valore associato alla chiave specificata.The value associated with the specified key. 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.If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new element using the specified key.

Implementazioni

Eccezioni

La proprietà è stata impostata e l'interfaccia Hashtable è in sola lettura.The property is set and the Hashtable is read-only.

-oppure--or- La proprietà è impostata, key non esiste nella raccolta e Hashtable è di dimensioni fisse.The property is set, key does not exist in the collection, and the Hashtable has a fixed size.

Commenti

Questa proprietà consente di accedere a un elemento specifico della raccolta utilizzando la sintassi seguente: myCollection[key].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[key].

È anche possibile usare la Item[Object] proprietà per aggiungere nuovi elementi impostando il valore di una chiave che non esiste Hashtablein, ad esempio myCollection["myNonexistentKey"] = myValue.You can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the Hashtable; for example, myCollection["myNonexistentKey"] = myValue. Tuttavia, se la chiave specificata esiste già nell'oggetto Hashtable, l'impostazione Item[Object] della proprietà sovrascrive il valore precedente.However, if the specified key already exists in the Hashtable, setting the Item[Object] property overwrites the old value. Al contrario, il Add metodo non modifica gli elementi esistenti.In contrast, the Add method does not modify existing elements.

Una chiave non può nullessere, ma un valore può essere.A key cannot be null, but a value can be. Per distinguere tra null l'oggetto restituito 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 chiave presente nell'elenco.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

Il recupero del valore di questa proprietà è un'operazione O (1). l'impostazione della proprietà è anche un'operazione O (1).Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.

Il C# linguaggio utilizza la this parola chiave per definire gli indicizzatori anziché implementare la Item[Int32] proprietà.The C# language uses the this keyword to define the indexers instead of implementing the Item[Int32] property. In Visual Basic la proprietà Item[Object] viene implementata come predefinita per fornire la stessa funzionalità di indicizzazione.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

Si applica a

Vedi anche