Hashtable.Item[Object] Propiedad
Definición
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, setDefault Public Overridable Property Item(key As Object) As ObjectPará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.
