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; }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 establecer.
Valor de propiedad
Valor asociado a la clave especificada. Si no se encuentra la clave especificada, al intentar obtenerla se devuelve nully se intenta establecer se crea un nuevo elemento mediante la clave especificada.
Implementaciones
Excepciones
key es null.
La propiedad se establece y Hashtable es de solo lectura.
O bien
La propiedad se establece, key no existe en la colección y Hashtable tiene un tamaño fijo.
Comentarios
Esta propiedad proporciona la capacidad de acceder a un elemento específico 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 , Hashtableal establecer la Item[] propiedad se 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# usa la this palabra clave para definir los indexadores en lugar de implementar la Item[] propiedad . Visual Basic implementa Item[] como una propiedad predeterminada, que proporciona la misma funcionalidad de indexación.