CKTIS / C#
ArgumentOutOfRangeException et KeyNotFoundException : indice de liste ou clé de dictionnaire
Les crochets accèdent à une liste par position et à un dictionnaire par clé. Un indice invalide et une clé absente provoquent des exceptions différentes.
Version : C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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 indique qu’un argument est hors de la plage autorisée. L’indexeur de List<T> lève cette exception à la lecture ou à l’écriture de list[index] si index < 0 ou index >= list.Count. Les positions commencent à zéro. Dans un tableau, un accès hors limites lève en revanche System.IndexOutOfRangeException.
La lecture de dictionary[key] dans un Dictionary<TKey, TValue> lève System.Collections.Generic.KeyNotFoundException si aucune clé ne correspond. Même de type int, une clé n’est pas une position. L’affectation dictionary[key] = value ajoute une entrée si la clé est absente ou remplace la valeur si elle existe. Une clé null provoque ArgumentNullException, et non KeyNotFoundException.
Si un indice risque d’être invalide, vérifiez 0 <= index && index < list.Count avant d’accéder à la liste. Si l’absence d’une clé est prévue, utilisez TryGetValue(key, out var value). La méthode renvoie true et fournit la valeur stockée si la clé existe, sinon elle renvoie false et fournit default(TValue). Vérifiez le résultat booléen et pas seulement la valeur : la valeur par défaut peut elle-même être stockée dans le dictionnaire. TryGetValue rejette aussi une clé null en levant ArgumentNullException.
Exemples
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");
}Résultat
List: ArgumentOutOfRangeException Dictionary: KeyNotFoundException TryGetValue: key not found
`1` est hors des limites de la liste à un élément et ne figure pas parmi les clés du dictionnaire. Les indexeurs lèvent eux-mêmes les exceptions ; les blocs `catch` affichent uniquement les noms des types. `TryGetValue` gère l’absence de la même clé sans lever d’exception.
Leçons associées
- C# · Leçon 7 · Intermédiaire · Version : 2