Leer en inglés

Compartir vía


Hashtable.Item[Object] Propiedad

Definición

Obtiene o establece el valor asociado a la clave 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; }
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

Parámetros

key
Object

Clave cuyo valor se va a obtener o a establecer.

Valor de propiedad

Valor asociado a la clave especificada. Si no se encuentra la clave especificada, al intentar obtenerla se devuelve null y al intentar establecerla se crea una nueva entrada con la clave especificada.

Implementaciones

Excepciones

key es null.

La propiedad está establecida y Hashtable es de solo lectura.

o bien

La propiedad está establecida, key no existe en la colección y Hashtable tiene un tamaño fijo.

Comentarios

Esta propiedad permite acceder a un elemento determinado de la colección mediante la sintaxis siguiente: myCollection[key].

También puede usar la Item[] propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe en Hashtable; por ejemplo, myCollection["myNonexistentKey"] = myValue. Sin embargo, si la clave especificada ya existe en Hashtable, al establecer la propiedad se Item[] sobrescribe el valor anterior. En cambio, el Add método no modifica los elementos existentes.

Una clave no puede ser null, pero un valor puede ser . Para distinguir entre null que se devuelve porque no se encuentra la clave especificada y null que se devuelve porque el valor de la clave especificada es null, use el Contains método o el ContainsKey método para determinar si la clave existe en la lista.

Recuperar el valor de esta propiedad es una O(1) operación; establecer la propiedad también es una O(1) operación.

El lenguaje C# utiliza la palabra clave this para definir los indizadores en lugar de implementar la propiedad de Item[]. Visual Basic implementa Item[] como propiedad predeterminada, lo que proporciona la misma funcionalidad de indización.

Se aplica a

Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Consulte también