SortedList.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 una clave específica de un objeto SortedList.
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 asociada al valor que se va a obtener o establecer.
Valor de propiedad
Valor asociado al parámetro key del objeto SortedList si se encuentra key; en caso contrario, null.
Implementaciones
Excepciones
key es null.
La propiedad está establecida y el objeto SortedList es de solo lectura.
o bien
La propiedad está establecida, key no existe en la colección y SortedList tiene un tamaño fijo.
No hay suficiente memoria disponible para agregar el elemento al objeto SortedList.
El comparador produce una excepción.
Comentarios
Puede usar la Item[] propiedad para tener acceso a un elemento específico de una colección especificando la sintaxis siguiente: myCollection[key].
También puede usar esta propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe en el SortedList objeto (por ejemplo, myCollection["myNonexistentKey"] = myValue). Sin embargo, si la clave especificada ya existe en SortedList, 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.
Los elementos de un SortedList objeto se ordenan por las claves según una implementación específica especificada IComparer cuando SortedList se crea o según la IComparable implementación proporcionada por las propias claves.
El lenguaje C# utiliza la palabra clave this para definir los indizadores en lugar de implementar la propiedad de Keys. Visual Basic implementa Item[] como propiedad predeterminada, lo que proporciona la misma funcionalidad de indización.
Recuperar el valor de esta propiedad es una O(log n) operación, donde n es Count. Establecer la propiedad es una O(log n) operación si la clave ya está en .SortedList Si la clave no está en la lista, establecer la propiedad es una O(n) operación para datos no ordenados o O(log n) si el nuevo elemento se agrega al final de la lista. Si la inserción provoca un cambio de tamaño, la operación es O(n).
