CKTIS / C#
ArgumentOutOfRangeException e KeyNotFoundException: indice di lista o chiave di dizionario
Le parentesi quadre accedono a una lista per posizione e a un dizionario per chiave. Un indice non valido e una chiave mancante causano eccezioni diverse.
Versione: C# 12 and .NET 8; later runtimes may add compatible features
Sintassi
List<T>: T this[int index] { get; set; } — list[index]
Dictionary<TKey, TValue>: TValue this[TKey key] { get; set; } — dictionary[key]
Dictionary<TKey, TValue>: bool TryGetValue(TKey key, out TValue value)System.ArgumentOutOfRangeException indica che un argomento è fuori dall’intervallo consentito. L’indicizzatore di List<T> genera questa eccezione in lettura o scrittura di list[index] se index < 0 oppure index >= list.Count. Le posizioni partono da zero. In un array, invece, un accesso fuori dai limiti genera System.IndexOutOfRangeException.
Leggere dictionary[key] da un Dictionary<TKey, TValue> genera System.Collections.Generic.KeyNotFoundException se non esiste una chiave corrispondente. Anche una chiave di tipo int non rappresenta una posizione. L’assegnazione dictionary[key] = value aggiunge una voce se la chiave manca o sostituisce il valore se la chiave esiste. Una chiave null causa ArgumentNullException, non KeyNotFoundException.
Se l’indice può non essere valido, controlla 0 <= index && index < list.Count prima di accedere alla lista. Se è previsto che una chiave possa mancare, usa TryGetValue(key, out var value). Il metodo restituisce true e fornisce il valore memorizzato se trova la chiave, altrimenti restituisce false e fornisce default(TValue). Controlla il risultato booleano, non solo il valore: anche il valore predefinito può essere memorizzato nel dizionario. TryGetValue rifiuta a sua volta una chiave null con ArgumentNullException.
Esempi
using System;
using System.Collections.Generic;
var list = new List<int> { 0 };
var dictionary = new Dictionary<int, int> { [0] = 0 };
int indexOrKey = 1;
try
{
_ = list[indexOrKey];
}
catch (ArgumentOutOfRangeException ex)
{
Console.WriteLine($"List: {ex.GetType().Name}");
}
try
{
_ = dictionary[indexOrKey];
}
catch (KeyNotFoundException ex)
{
Console.WriteLine($"Dictionary: {ex.GetType().Name}");
}
if (!dictionary.TryGetValue(indexOrKey, out _))
{
Console.WriteLine("TryGetValue: key not found");
}Risultato
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` è fuori dai limiti della lista con un solo elemento e non compare tra le chiavi del dizionario. Sono gli indicizzatori a generare le eccezioni; i blocchi `catch` stampano soltanto i nomi dei tipi. `TryGetValue` gestisce la stessa chiave mancante senza generare eccezioni.
Lezioni correlate
- C# · Lezione 7 · Intermedio · Versione: 2