C# Academy · Les

Collection builders

Ondersteun collectie-expressies in aangepaste types.

Les 4 van 413 stappen

Collection builders is een gratis C# Academy-les op CoddyKit. Dit is les 4 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject C# Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus C# Academy bevat in totaal 4 lessen.

Aangepaste typen in collectie-expressies

Collectie-expressies zijn niet beperkt tot ingebouwde typen. Met het kenmerk [CollectionBuilder] kan je eigen type worden gemaakt met de syntaxis [...].

Het kenmerk CollectionBuilder

Je past [CollectionBuilder(typeof(Factory), "Create")] toe op je collectietype. Hiermee geef je een statische fabrieksmethode aan die de compiler aanroept om instanties te maken.

Handtekening van de bouwmethode

De bouwmethode moet static zijn, één parameter van het type ReadOnlySpan<T> accepteren en je collectietype retourneren. De compiler geeft de elementen als een span door.

Een minimale aangepaste collectie

Hier zie je een kleine onveranderlijke collectie die het maken via collectie-expressies met behulp van een bouwer ondersteunt.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.CompilerServices;

[CollectionBuilder(typeof(IntBagBuilder), "Create")]
class IntBag : IEnumerable<int> {
    private readonly int[] items;
    public IntBag(ReadOnlySpan<int> data) => items = data.ToArray();
    public IEnumerator<int> GetEnumerator() => ((IEnumerable<int>)items).GetEnumerator();
    IEnumerator IEnumerable.GetEnumerator() => items.GetEnumerator();
}

static class IntBagBuilder {
    public static IntBag Create(ReadOnlySpan<int> data) => new IntBag(data);
}

IntBag bag = [1, 2, 3];
foreach (int n in bag) Console.Write(n + " "); // 1 2 3
Console.WriteLine();

Waarom ReadOnlySpan?

Dankzij de spanparameter kan de compiler de elementen doorgeven zonder tussentijdse toewijzing. Je bouwer kopieert ze naar de opslag die daarvoor nodig is.

Het moet IEnumerable zijn

Het collectietype moet IEnumerable<T> implementeren, waarbij het elementtype overeenkomt met dat van de span. Zo kent de compiler het elementtype en kan die het gebruik valideren.

Generieke bouwers

Bouwers kunnen generiek zijn en bijvoorbeeld MyCollection<T> ondersteunen. De bouwmethode accepteert ReadOnlySpan<T> en retourneert MyCollection<T>.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.CompilerServices;

[CollectionBuilder(typeof(BoxBuilder), "Create")]
class Box<T> : IEnumerable<T> {
    private readonly T[] items;
    public Box(ReadOnlySpan<T> d) => items = d.ToArray();
    public IEnumerator<T> GetEnumerator() => ((IEnumerable<T>)items).GetEnumerator();
    IEnumerator IEnumerable.GetEnumerator() => items.GetEnumerator();
}

static class BoxBuilder {
    public static Box<T> Create<T>(ReadOnlySpan<T> d) => new Box<T>(d);
}

Box<string> b = ["x", "y"];
foreach (var s in b) Console.Write(s + " "); // x y
Console.WriteLine();

Voordeel voor onveranderlijke collecties

Bouwers zorgen ervoor dat de onveranderlijke collecties van .NET, zoals ImmutableArray<T>, collectie-expressies ondersteunen. De bouwer maakt vanuit de span een bevroren instantie.

using System;
using System.Collections.Immutable;

ImmutableArray<int> nums = [1, 2, 3];
Console.WriteLine(nums.Length); // 3

Spreidelementen werken ook

Zodra een type een bouwer heeft, werken spreidelementen automatisch in de collectie-expressies ervan, omdat de compiler nog steeds één span met elementen maakt.

using System;
using System.Collections.Immutable;

ImmutableArray<int> a = [1, 2];
ImmutableArray<int> all = [..a, 3, 4];
Console.WriteLine(all.Length); // 4

Wanneer voeg je een bouwer toe?

Voeg [CollectionBuilder] toe wanneer je een aangepaste collectie aanbiedt en aanroepers de beknopte syntaxis [...] wilt laten gebruiken, vooral voor onveranderlijke of gespecialiseerde containers.

Alles samenbrengen

Een bouwer bestaat uit slechts drie onderdelen: het kenmerk, een type dat IEnumerable<T> implementeert en een statische methode Create(ReadOnlySpan<T>). Daarmee wordt je type een volwaardig doeltype voor collectie-expressies.

Snelle controle

Bevestig aan welke vereisten een collectie-bouwer moet voldoen.

Beantwoord dit in de interactieve les

Samenvatting

Je hebt geleerd hoe aangepaste typen collectie-expressies ondersteunen.

Pas [CollectionBuilder(typeof(Factory), "Create")] toe op het type.
De fabriek is een static-methode die ReadOnlySpan<T> accepteert.
Het type moet IEnumerable<T> implementeren.
Zo accepteert ImmutableArray<T> de syntaxis [...].

Gratis beginnen

Leer C# met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 93
Lessen: 346

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Collection builders” gratis?

Ja — de volledige tekst van “Collection builders” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus C# Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus C# Academy bevat in totaal 4 lessen.

Wat leer ik in “Collection builders”?

Ondersteun collectie-expressies in aangepaste types. Je oefent met C# Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met C# Academy te beginnen?

Ervaring vooraf is niet nodig. C# Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 4 van 4.

Hoe lang duurt de les “Collection builders”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over C# Academy?

Ja. Elke les over C# Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

← Terug naar C# Academy