KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

ArgumentOutOfRangeException en KeyNotFoundException: lijstindex of sleutel

Vierkante haken geven toegang tot een lijst op positie en tot een dictionary op sleutel. Een ongeldige index en een ontbrekende sleutel geven verschillende uitzonderingen.

Versie: C# 12 and .NET 8; later runtimes may add compatible features

Syntax

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 betekent dat een argument buiten het toegestane bereik valt. De indexer van List<T> werpt deze uitzondering op bij het lezen of schrijven van list[index] als index < 0 of index >= list.Count. Posities beginnen bij nul. Bij een array levert toegang buiten de grenzen juist System.IndexOutOfRangeException op.

Bij het lezen van dictionary[key] uit een Dictionary<TKey, TValue> krijg je System.Collections.Generic.KeyNotFoundException als er geen overeenkomende sleutel is. Ook een sleutel van het type int is geen positie. De toewijzing dictionary[key] = value voegt een item toe als de sleutel ontbreekt, of vervangt de waarde als de sleutel al bestaat. Een null-sleutel leidt tot ArgumentNullException, niet tot KeyNotFoundException.

Als een index ongeldig kan zijn, controleer dan 0 <= index && index < list.Count vóór toegang tot de lijst. Als een sleutel mag ontbreken, gebruik dan TryGetValue(key, out var value). De methode geeft true en de opgeslagen waarde bij een treffer, of false en default(TValue) als de sleutel ontbreekt. Controleer het booleaanse resultaat en niet alleen de waarde: ook de standaardwaarde kan in de dictionary zijn opgeslagen. TryGetValue wijst een null-sleutel eveneens af met ArgumentNullException.

Voorbeelden

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");
}

Resultaat

List: ArgumentOutOfRangeException
Dictionary: KeyNotFoundException
TryGetValue: key not found

`1` valt buiten de grenzen van de lijst met één element en ontbreekt als sleutel in de dictionary. De indexers werpen zelf de uitzonderingen op; de `catch`-blokken tonen alleen de typenamen. `TryGetValue` handelt dezelfde ontbrekende sleutel af zonder uitzondering.

Gerelateerde lessen

  • C# · Les 7 · Gemiddeld · Versie: 2

Bronnen