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 SortedList objeto .
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 key parámetro en el SortedList objeto , si key se encuentra; en caso contrario, null.
Implementaciones
Excepciones
key es null.
La propiedad se establece y el SortedList objeto es de solo lectura.
O bien
La propiedad se establece, key no existe en la colección y SortedList tiene un tamaño fijo.
No hay suficiente memoria disponible para agregar el elemento a 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 , SortedListal 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.
Los elementos de un SortedList objeto se ordenan por las claves según una implementación específica IComparer especificada cuando SortedList se crea o según la IComparable implementación proporcionada por las claves.
El lenguaje C# usa la this palabra clave para definir los indexadores en lugar de implementar la Keys propiedad . Visual Basic implementa Item[] como una propiedad predeterminada, que proporciona la misma funcionalidad de indexació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).
