C# Academy · Lekcja

Modyfikator required

Wymuszaj ustawianie istotnych właściwości przez wywołującego.

Modyfikator required to bezpłatna lekcja C# Academy na CoddyKit. To lekcja 2 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.

Modyfikator required

Modyfikator required wymusza ustawienie właściwości lub pola przez kod tworzący obiekt. Przenosi błędy typu „zapomniano podać wartość” z czasu działania do czasu kompilacji.

using System;

class Person {
    public required string Name { get; init; }
}

var p = new Person { Name = "Ada" };
Console.WriteLine(p.Name); // Ada

Pominięcie składowej required powoduje błąd kompilacji

Jeśli kod tworzący obiekt pominie wymaganą składową, kompilator zgłosi błąd, zanim program zostanie uruchomiony.

using System;

class Person {
    public required string Name { get; init; }
}

// var bad = new Person { }; // compile error: Name is required
var good = new Person { Name = "Lin" };
Console.WriteLine(good.Name); // Lin

required z init

required naturalnie łączy się z init: wartość musi zostać podana podczas tworzenia obiektu i nie może później ulec zmianie.

using System;

class Config {
    public required string Url { get; init; }
    public int Timeout { get; init; } = 30;
}

var c = new Config { Url = "https://api" };
Console.WriteLine(c.Url + " " + c.Timeout); // https://api 30

required z set

Właściwość z akcesorem set również można oznaczyć jako wymaganą. Musi zostać zainicjalizowana, ale później nadal można ją zmieniać.

using System;

class Box {
    public required int Size { get; set; }
}

var b = new Box { Size = 5 };
b.Size = 10; // still mutable
Console.WriteLine(b.Size); // 10

Pola required

Pola również mogą być wymagane, nie tylko właściwości.

using System;

class Token {
    public required string Value;
}

var t = new Token { Value = "abc123" };
Console.WriteLine(t.Value); // abc123

Konstruktory i required

Jeśli konstruktor ustawia wymaganą składową, kod korzystający z tego konstruktora nie musi już ustawiać jej samodzielnie. Należy użyć [SetsRequiredMembers], aby poinformować o tym kompilator.

using System;
using System.Diagnostics.CodeAnalysis;

class Person {
    public required string Name { get; init; }
    [SetsRequiredMembers]
    public Person(string name) => Name = name;
}

Console.WriteLine(new Person("Sam").Name); // Sam

Łączenie składowych required i opcjonalnych

Obowiązkowe są tylko składowe oznaczone jako wymagane; pozostałe pozostają opcjonalne i zachowują swoje wartości domyślne.

using System;

class Account {
    public required string Owner { get; init; }
    public decimal Balance { get; init; } = 0m;
}

var a = new Account { Owner = "Kai" };
Console.WriteLine(a.Owner + " " + a.Balance); // Kai 0

required w dziedziczeniu

Wymagane składowe są dziedziczone. Klasa pochodna może dodać własne wymagane składowe, a wszystkie wymagania muszą zostać spełnione.

using System;

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

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

Zastępowanie rozbudowanych konstruktorów

Połączenie required + init często zastępuje rozbudowane konstruktory: zapewnia obowiązkowe składowe wraz z czytelną składnią inicjalizatora obiektu.

using System;

class Email {
    public required string To { get; init; }
    public required string Subject { get; init; }
    public string Body { get; init; } = "";
}

var e = new Email { To = "a@b.com", Subject = "Hi" };
Console.WriteLine(e.To + " | " + e.Subject); // a@b.com | Hi

Jawne określanie wymagań

Oznaczenie składowych jako wymaganych dokumentuje, które wartości są niezbędne, i ułatwia prawidłowe korzystanie z typu.

using System;

class Registration {
    public required string Username { get; init; }
    public required string Password { get; init; }
    public bool Newsletter { get; init; }
}

var r = new Registration { Username = "ada", Password = "x" };
Console.WriteLine(r.Username); // ada

Połączenie wszystkiego

Typ łączący wymagane, opcjonalne i walidowane składowe.

using System;

class Server {
    public required string Host { get; init; }
    public int Port { get; init; } = 8080;
    public string Address => Host + ":" + Port;
}

var s = new Server { Host = "localhost" };
Console.WriteLine(s.Address); // localhost:8080

Szybkie sprawdzenie

Proszę potwierdzić, co gwarantuje modyfikator required.

Podsumowanie

W tej części poznano modyfikator required.

Wymusza inicjalizację składowej podczas tworzenia obiektu, a wymaganie jest sprawdzane przez kompilator.
Łączy się z init, tworząc obowiązkowe i niezmienne składowe.
[SetsRequiredMembers] pozwala konstruktorowi spełnić wymaganie.
Wymagane składowe są dziedziczone.

Często zadawane pytania

Czy lekcja „Modyfikator required” jest bezpłatna?

Tak — pełny tekst „Modyfikator required” 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 „Modyfikator required”?

Wymuszaj ustawianie istotnych właściwości przez wywołującego. Ć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 2 z 4.

Ile czasu zajmuje lekcja „Modyfikator required”?

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