KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Elementtoegang: array[index]

De expressie array[index] leest of wijzigt een arrayelement. Vierkante haken [] bieden ook toegang tot indexers; de betekenis van de argumenten hangt dan af van het betreffende type.

Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

array[index]
array[index] = value;
matrix[row, column]
objectWithIndexer[key]

array[index] duidt een arrayelement aan: array is een expressie die een array oplevert en index geeft de positie aan. In een gewone eendimensionale C#-array beginnen indices bij 0 en eindigen ze bij array.Length - 1. Lezen haalt de waarde van het element op, terwijl array[index] = value een nieuwe waarde opslaat zonder de lengte van de array te wijzigen.

Een index buiten de grenzen van de array veroorzaakt IndexOutOfRangeException; toegang via een verwijzing die gelijk is aan null veroorzaakt NullReferenceException. Een lege array heeft geen geldige elementindex. array?[index] slaat de toegang over als de array null is, maar beschermt bij een bestaande array niet tegen een ongeldige index.

Een rechthoekige array gebruikt één index per dimensie, zoals matrix[row, column]. Een gekartelde array gebruikt opeenvolgende toegangsbewerkingen, zoals rows[row][column]. Dezelfde notatie [] ondersteunt toegang tot indexers van objecten; het argument kan bijvoorbeeld een tekstreeksleutel zijn. De regels voor lezen, schrijven en uitzonderingen hangen af van het type; ga niet uit van arraygedrag. Je kunt [] niet rechtstreeks overloaden — aangepaste typen bieden in plaats daarvan indexers.

De haken in int[] declareren een arraytype; ze lezen geen element. Het voorbeeld laat het eenvoudig lezen en schrijven van elementen zien, zonder functies waarvoor een preview-taalversie nodig is.

Voorbeelden

using System;

class Program
{
    static void Main()
    {
        int[] array = { 10, 20, 30 };
        int index = 1;
        Console.WriteLine(array[index]);
        array[index] = 25;
        Console.WriteLine(array[index]);
        Console.WriteLine(array[0]);
    }
}

Resultaat

20
25
10

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen