SortedList.Item[Object] Proprietà

Definizione

Spazio dei nomi:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Source:

SortedList.cs

Ottiene o imposta il valore associato a una chiave specifica in un oggetto 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; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

Parametri

key

Object

Chiave associata al valore da ottenere o impostare.

Valore della proprietà

Object

Valore associato al parametro key nell'oggetto SortedList, se il parametro key è presente; in caso contrario, null.

Implementazioni

Item[Object]

Eccezioni

ArgumentNullException

key è null.

NotSupportedException

La proprietà è impostata e l'oggetto SortedList è in sola lettura.

-oppure-

La proprietà è impostata, key non esiste nella raccolta e SortedList è di dimensioni fisse.

OutOfMemoryException

La memoria disponibile non è sufficiente per aggiungere l'elemento all'oggetto SortedList.

InvalidOperationException

L'operatore di confronto genera un'eccezione.

Commenti

È possibile utilizzare la Item[] proprietà per accedere a un elemento specifico in una raccolta specificando la sintassi seguente: myCollection[key].

È anche possibile utilizzare questa proprietà per aggiungere nuovi elementi impostando il valore di una chiave che non esiste nell'oggetto SortedList , myCollection["myNonexistentKey"] = myValue)ad esempio . Tuttavia, se la chiave specificata esiste già in , l'impostazione SortedListdella Item[] proprietà sovrascrive il valore precedente. Al contrario, il Add metodo non modifica gli elementi esistenti.

Una chiave non può essere null, ma un valore può essere . Per distinguere null la chiave restituita perché la chiave specificata non viene trovata e null restituita perché il valore della chiave specificata è null, utilizzare il Contains metodo o il ContainsKey metodo per determinare se la chiave esiste nell'elenco.

Gli elementi di un oggetto SortedList vengono ordinati in base alle chiavi in base a un'implementazione specifica IComparer specificata quando SortedList viene creato o in base all'implementazione IComparable fornita dalle chiavi stesse.

Nel linguaggio C# viene utilizzata la parola chiave this per definire gli indicizzatori anziché implementare la proprietà Keys. In Visual Basic la proprietà Item[] viene implementata come predefinita per fornire la stessa funzionalità di indicizzazione.

Il recupero del valore di questa proprietà è un'operazione O(log n) , dove n è Count. L'impostazione della proprietà è un'operazione O(log n) se la chiave è già presente in SortedList. Se la chiave non è presente nell'elenco, l'impostazione della proprietà è un'operazione O(n) per i dati non ordinato o O(log n) se il nuovo elemento viene aggiunto alla fine dell'elenco. Se l'inserimento causa un ridimensionamento, l'operazione è O(n).

Vedi anche

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Esecuzione di operazioni sulle stringhe indipendenti dalle impostazioni cultura nelle raccolte