Hashtable.Item[Object] Propiedad
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- key
- Object
Clave cuyo valor se va a obtener o a establecer.
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.
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.
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.
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 |
Comentarios de .NET
.NET es un proyecto de código abierto. Selecciona un vínculo para proporcionar comentarios: