Akademi C# · Pelajaran

Pembina Koleksi

Sokong ungkapan koleksi dalam jenis tersuai.

Pelajaran 4 daripada 413 langkah

Pembina Koleksi ialah pelajaran Akademi C# percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Akademi C#, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.

Jenis Tersuai dalam Ungkapan Koleksi

Ungkapan koleksi tidak terhad kepada jenis terbina dalam. Dengan atribut [CollectionBuilder], jenis anda sendiri boleh dicipta menggunakan sintaks [...].

Atribut CollectionBuilder

Anda menggunakan [CollectionBuilder(typeof(Factory), "Create")] pada jenis koleksi anda. Atribut ini menamakan kaedah kilang statik yang dipanggil oleh pengkompil untuk membina tika.

Tandatangan Kaedah Pembina

Kaedah pembina mestilah static dan menerima satu parameter ReadOnlySpan<T>, serta mengembalikan jenis koleksi anda. Pengkompil menghantar elemen sebagai rentang.

Koleksi Tersuai Minimum

Berikut ialah koleksi kecil yang tidak berubah dan memilih penciptaan melalui ungkapan koleksi menggunakan pembina.

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();

Mengapa ReadOnlySpan?

Parameter rentang membolehkan pengkompil menyerahkan elemen tanpa peruntukan perantaraan. Pembina anda menyalinnya ke dalam storan yang diperlukan.

Mestilah IEnumerable

Jenis koleksi mesti melaksanakan IEnumerable<T> (sepadan dengan jenis elemen rentang) supaya pengkompil mengetahui jenis elemen dan boleh mengesahkan penggunaannya.

Pembina Generik

Pembina boleh bersifat generik untuk menyokong MyCollection<T>. Kaedah pembina menerima ReadOnlySpan<T> dan mengembalikan 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();

Manfaat Koleksi Tidak Berubah

Pembina ialah cara koleksi tidak berubah .NET, seperti ImmutableArray<T>, menyokong ungkapan koleksi. Pembina mencipta tika beku daripada rentang tersebut.

using System;
using System.Collections.Immutable;

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

Sebaran Turut Berfungsi

Setelah sesuatu jenis mempunyai pembina, sebaran akan berfungsi secara automatik dalam ungkapan koleksinya kerana pengkompil masih menghasilkan satu rentang elemen.

using System;
using System.Collections.Immutable;

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

Bila Hendak Menambah Pembina

Tambahkan [CollectionBuilder] apabila anda mengedarkan koleksi tersuai dan mahu pemanggil menikmati sintaks [...] yang ringkas, khususnya untuk bekas yang tidak berubah atau khusus.

Menggabungkan Semuanya

Pembina hanya terdiri daripada tiga bahagian: atribut, jenis IEnumerable<T> dan kaedah Create(ReadOnlySpan<T>) statik. Dengan semua ini, jenis anda menjadi sasaran ungkapan koleksi kelas pertama.

Semakan Pantas

Sahkan keperluan untuk pembina koleksi.

Jawab dalam pelajaran interaktif

Imbas Kembali

Anda telah mempelajari cara jenis tersuai menyokong ungkapan koleksi.

Gunakan [CollectionBuilder(typeof(Factory), "Create")] pada jenis tersebut.
Kilang ialah kaedah static yang menerima ReadOnlySpan<T>.
Jenis tersebut mesti melaksanakan IEnumerable<T>.
Inilah cara ImmutableArray<T> menerima [...].

Percuma untuk bermula

Pelajari C# dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 93
Pelajaran: 346

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Pembina Koleksi” percuma?

Ya — teks penuh “Pembina Koleksi” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Akademi C#, tingkat taraf kepada CoddyKit PRO. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Pembina Koleksi”?

Sokong ungkapan koleksi dalam jenis tersuai. Anda berlatih Akademi C# menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Akademi C#?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Akademi C# di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Pembina Koleksi” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Akademi C# ini?

Ya. Setiap pelajaran Akademi C# menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Akademi C#