SortedList.Item[Object] Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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; }public virtual object? this[object key] { get; set; }member this.Item(obj) : obj with get, setDefault Public Overridable Property Item(key As Object) As ObjectParametri
- key
- Object
Chiave associata al valore da ottenere o impostare.
Valore della proprietà
Valore associato al parametro key nell'oggetto SortedList, se il parametro key è presente; in caso contrario, null.
Implementazioni
Eccezioni
key è null.
La proprietà è impostata e l'oggetto SortedList è in sola lettura.
-oppure-
La proprietà è impostata, key non esiste nella raccolta e SortedList è di dimensioni fisse.
La memoria disponibile non è sufficiente per aggiungere l'elemento all'oggetto SortedList.
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).
