required修飾子
呼び出し側に必須プロパティの設定を強制します。
「required修飾子」はCoddyKit上の無料C# Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはC# Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 C# Academyコースには全4レッスンが含まれています。
required 修飾子
required修飾子を使うと、オブジェクトの作成時に呼び出し側がプロパティ（またはフィールド）を設定するよう強制できます。「値の設定を忘れた」というエラーを実行時からコンパイル時に移せます。
using System;
class Person {
public required string Name { get; init; }
}
var p = new Person { Name = "Ada" };
Console.WriteLine(p.Name); // Adarequired メンバーを省略するとコンパイルに失敗する
呼び出し側が required メンバーを省略すると、プログラムが実行される前にコンパイラーがエラーを報告します。
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); // Linrequired と init
requiredとinitは自然な組み合わせです。構築時に値を指定する必要があり、その後は変更できません。
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 30required と set
set 可能なプロパティにも required を指定できます。初期化は必要ですが、その後も変更できます。
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); // 10required フィールド
required はプロパティだけでなく、フィールドにも指定できます。
using System;
class Token {
public required string Value;
}
var t = new Token { Value = "abc123" };
Console.WriteLine(t.Value); // abc123コンストラクターと required
コンストラクターが required メンバーを設定する場合、そのコンストラクターを使う呼び出し側は設定する必要がなくなります。コンパイラーに伝えるには[SetsRequiredMembers]を使います。
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); // Samrequired とオプションの組み合わせ
必須になるのは required を指定したメンバーだけです。それ以外のメンバーは既定値を持つオプションのままです。
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
required メンバーは継承されます。派生クラスで独自の required メンバーを追加でき、すべてを満たす必要があります。
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大規模なコンストラクターを置き換える
required + initを使うと、大規模なコンストラクターを置き換えられることがよくあります。必須メンバーを指定しながら、読みやすいオブジェクト初期化子構文を利用できます。
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意図を自己文書化する
メンバーに required を指定すると、どの値が必須なのかが明確になり、その型を正しく使いやすくなります。
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まとめて実装する
必須、オプション、検証付きのメンバーを組み合わせた型です。
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簡単な確認
required 修飾子が保証する内容を確認してください。
まとめ
required修飾子について学びました。
- 作成時に呼び出し側がメンバーを初期化するよう強制し、コンパイラーが検査します。
initと組み合わせると、必須かつ不変のメンバーを作成できます。[SetsRequiredMembers]を使うと、コンストラクターで要件を満たせます。- required メンバーは継承されます。
よくある質問
「required修飾子」レッスンは無料ですか？
はい。「required修飾子」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、C# Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 C# Academyコースには全4レッスンが含まれています。
「required修飾子」で何を学びますか？
呼び出し側に必須プロパティの設定を強制します。 ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
C# Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのC# Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「required修飾子」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このC# Academyレッスンでコードを書いて実行できますか？
はい。すべてのC# Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- init専用setter
- required修飾子
- 不変オブジェクトのパターン
- レコードのwith式