SortedList.Item[Object] Propiedad

Definición

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, set
Default Public Overridable Property Item(key As Object) As Object

Pará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 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 se SortedList 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).

Se aplica a

Consulte también