C# Academy · Lekcja

Settery tylko z init

Twórz właściwości, które można ustawiać tylko podczas inicjalizacji.

Settery tylko z init to bezpłatna lekcja C# Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej C# Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs C# Academy zawiera 4 lekcji w sumie.

Settery init-only

Akcesor init pozwala ustawić właściwość podczas tworzenia obiektu, także w inicjalizatorach obiektu, ale później czyni ją tylko do odczytu. Postać takiej właściwości to { get; init; }.

using System;

class Point {
    public int X { get; init; }
    public int Y { get; init; }
}

var p = new Point { X = 3, Y = 4 };
Console.WriteLine(p.X + "," + p.Y); // 3,4

Ustawianie tylko podczas inicjalizacji

Po utworzeniu obiektu przypisanie wartości do właściwości z akcesorem init powoduje błąd kompilacji, gwarantując niezmienność po utworzeniu.

using System;

class Config {
    public string Name { get; init; }
}

var c = new Config { Name = "prod" };
// c.Name = "dev"; // compile error
Console.WriteLine(c.Name); // prod

Inicjalizatory obiektów nadal działają

Największą zaletą w porównaniu z właściwością tylko do odczytu z akcesorem get-only jest to, że init obsługuje składnię inicjalizatora obiektu, więc nie trzeba tworzyć konstruktora dla każdej właściwości.

using System;

class Settings {
    public bool DarkMode { get; init; }
    public int FontSize { get; init; }
}

var s = new Settings { DarkMode = true, FontSize = 14 };
Console.WriteLine(s.DarkMode + " " + s.FontSize); // True 14

Łączenie z konstruktorami

Właściwości init można ustawiać w konstruktorze, a jednocześnie zezwalać na ich nadpisywanie w inicjalizatorach.

using System;

class User {
    public string Role { get; init; } = "guest";
    public User() { }
}

var u = new User { Role = "admin" };
Console.WriteLine(u.Role); // admin

Wartości domyślne

Właściwości init mogą mieć domyślne inicjalizatory, które obowiązują, chyba że zostaną nadpisane podczas tworzenia obiektu.

using System;

class Options {
    public int Retries { get; init; } = 3;
}

Console.WriteLine(new Options().Retries);            // 3
Console.WriteLine(new Options { Retries = 5 }.Retries); // 5

init a set

Akcesor set pozwala modyfikować wartość w dowolnym momencie, natomiast init ogranicza przypisanie do etapu tworzenia obiektu. Dla danych, które po utworzeniu nie powinny się zmieniać, należy wybrać init.

using System;

class Mutable { public int V { get; set; } }
class Frozen  { public int V { get; init; } }

var m = new Mutable { V = 1 };
m.V = 2; // allowed
Console.WriteLine(m.V); // 2

init z walidacją

Można zaimplementować jawne ciało init z polem zapasowym, aby walidować przypisywaną wartość.

using System;

class Percentage {
    private int _value;
    public int Value {
        get => _value;
        init => _value = (value < 0 || value > 100)
            ? throw new ArgumentOutOfRangeException()
            : value;
    }
}

Console.WriteLine(new Percentage { Value = 80 }.Value); // 80

init w rekordach

Właściwości rekordów pozycyjnych są domyślnie właściwościami tylko z akcesorem init, dlatego rekordy są niezmienne, a jednocześnie obsługują kopie tworzone za pomocą with.

using System;

record Account(string Id, decimal Balance);

var a = new Account("A1", 100m);
Console.WriteLine(a.Balance); // 100

Zagnieżdżone inicjalizatory obiektów

init współpracuje z zagnieżdżonymi inicjalizatorami obiektów, umożliwiając budowanie złożonych, niezmiennych grafów obiektów w jednym wyrażeniu.

using System;

class Address { public string City { get; init; } }
class Person { public string Name { get; init; } public Address Home { get; init; } }

var p = new Person { Name = "Lin", Home = new Address { City = "Oslo" } };
Console.WriteLine(p.Name + " / " + p.Home.City); // Lin / Oslo

init a dziedziczenie

Klasy pochodne mogą ustawiać bazowe właściwości init za pomocą inicjalizatorów obiektów, ponieważ etap tworzenia obejmuje cały obiekt.

using System;

class Base { public int Id { get; init; } }
class Item : Base { public string Name { get; init; } }

var i = new Item { Id = 1, Name = "Pen" };
Console.WriteLine(i.Id + " " + i.Name); // 1 Pen

Połączenie wszystkiego

Niezmienny obiekt DTO zbudowany wyłącznie z właściwości init i inicjalizatora obiektu.

using System;

class OrderDto {
    public int Id { get; init; }
    public string Customer { get; init; }
    public decimal Amount { get; init; }
}

var o = new OrderDto { Id = 7, Customer = "Ada", Amount = 49.9m };
Console.WriteLine(o.Id + " " + o.Customer + " " + o.Amount); // 7 Ada 49.9

Szybkie sprawdzenie

Proszę sprawdzić zrozumienie setterów init-only.

Podsumowanie

W tej części poznano settery init-only.

{ get; init; } pozwala przypisywać wartości tylko podczas tworzenia obiektu.
Inicjalizatory obiektów współpracują z właściwościami init.
Walidację można dodać za pomocą jawnego ciała init.
Właściwości pozycyjne rekordów domyślnie używają init.

Często zadawane pytania

Czy lekcja „Settery tylko z init” jest bezpłatna?

Tak — pełny tekst „Settery tylko z init” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu C# Academy, przejdź na CoddyKit PRO. Kurs C# Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Settery tylko z init”?

Twórz właściwości, które można ustawiać tylko podczas inicjalizacji. Ćwiczysz C# Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć C# Academy?

Nie wymagamy żadnego doświadczenia. C# Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Settery tylko z init”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji C# Academy?

Tak. Każda lekcja C# Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do C# Academy