C# Init Keyword（開発者向けの仕組み）

Init キーワードの基本的な例

基本的な例から始めましょう：

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

var person = new Person
{
    FirstName = "Iron",
    LastName = "Dev"
};

// person.FirstName = "Jane";  // This will give a compile-time error.

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

var person = new Person
{
    FirstName = "Iron",
    LastName = "Dev"
};

// person.FirstName = "Jane";  // This will give a compile-time error.

この例では、FirstName と LastName が init-only プロパティとしてマークされています。 これは、オブジェクトの初期化時だけに代入できることを意味します。 オブジェクトが作成された後、値を変更しようとするとコンパイル時エラーになります。

なぜ Init キーワードを使用するのか？

init キーワードを使用する主な理由は、初期化後にオブジェクトプロパティをイミュータブルにすることです。 従来、プロパティを読み取り専用としてマークしてイミュータビリティを実現することができました。 しかしながら、フィールドを設定するためのすべての必要な値を受け入れるコンストラクターがしばしば必要になり、コンストラクターボイラープレートコードの原因となることがあります。 init を使用すれば、長いコンストラクターを書くことなく、オブジェクト初期化子を使用して同じ目標を達成できます。

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
    // Without using constructor boilerplate for property initialization
}

var person = new Person
{
    FirstName = "John",
    LastName = "Doe"
};

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
    // Without using constructor boilerplate for property initialization
}

var person = new Person
{
    FirstName = "John",
    LastName = "Doe"
};

Init のみのプロパティによるオブジェクトの初期化

init を使用すると、オブジェクト初期化子とシームレスに連携できます。 コンストラクターに頼らずに値を設定する代わりに、オブジェクトを作成しながら必要なプロパティを直接定義できます。

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

var point = new Point { X = 10, Y = 20 };

// point.X = 30;  // This will throw a compile-time error

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

var point = new Point { X = 10, Y = 20 };

// point.X = 30;  // This will throw a compile-time error

これにより、Point 型の単純な不変オブジェクトが作成されます。 X と Y の値は初期化時に設定され、後で変更できないことに注意してください。

コンストラクターとの Init の混合利用

init の主な使用ケースはオブジェクト初期化子を通じたオブジェクト初期化ですが、必要に応じてコンストラクターを使用することもできます。 これはオブジェクトの作成中に特定のプロパティ値を強制する際に特に有用です。

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }

    public Person(string firstName, string lastName)
    {
        FirstName = firstName;
        LastName = lastName;
    }
}

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }

    public Person(string firstName, string lastName)
    {
        FirstName = firstName;
        LastName = lastName;
    }
}

コンストラクターと init プロパティの両方を一緒に使用できます。 このアプローチは、オブジェクト構築後のイミュータビリティを維持しながら、より多くの柔軟性を提供します。

Private Set よりも Init の利点

以前の開発者は、クラス外部でのプロパティ変更を制限するためにプライベート set アクセサーを使用していました。

public class Person
{
    public string FirstName { get; private set; }
    public string LastName { get; private set; }

    public Person(string firstName, string lastName)
    {
        FirstName = firstName;
        LastName = lastName;
    }
}

public class Person
{
    public string FirstName { get; private set; }
    public string LastName { get; private set; }

    public Person(string firstName, string lastName)
    {
        FirstName = firstName;
        LastName = lastName;
    }
}

このアプローチは機能しますが、プロパティを初期化するためにコンストラクターボイラープレートコードが必要です。 また、クラス自体が後でプロパティを変更できるようになるため、必ずしもイミュータブルなオブジェクトに理想的であるとは限りません。 init キーワードは、この問題を解決します。オブジェクト作成時の初期化のみを許可し、その後の変更はブロックされます。

読み取り専用フィールドと Init アクセサーによる初期化の処理

init キーワードは、オブジェクト作成時にフィールドまたはプロパティを初期化し、その後イミュータブルのままにします。 読み取り専用フィールドはイミュータビリティを提供しますが、init アクセサーはプロパティに対して同様の機能を提供します。 ここでは、読み取り専用フィールドと init プロパティを使用してイミュータビリティを処理する方法を示します。

public class Person
{
    private readonly string firstName;
    private readonly string lastName;

    public string FirstName => firstName;
    public string LastName => lastName;

    public Person(string firstName, string lastName)
    {
        this.firstName = firstName;
        this.lastName = lastName;
    }
}

public class Person
{
    private readonly string firstName;
    private readonly string lastName;

    public string FirstName => firstName;
    public string LastName => lastName;

    public Person(string firstName, string lastName)
    {
        this.firstName = firstName;
        this.lastName = lastName;
    }
}

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

public class Person
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

IronPDFの紹介

IronPDF は、C# 開発者向けに設計された強力な PDF 生成および操作ライブラリです。 PDF を HTML、CSS、画像、その他のコンテンツから変換して作成する作業を簡素化します。 ピクセルパーフェクトなレンダリング、クロスプラットフォームのサポート、および .NET プロジェクトへの簡単な統合などの機能を備えた IronPDF は、高品質な PDF を迅速に作成する必要がある開発者に最適です。 .NET Core、Framework、および Standard で使用でき、Windows、Linux、macOS など幅広いプラットフォームをサポートします。

Install-Package IronPdf

using IronPdf;

public class Person
{
    public int Id { get; init; }
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

public class PDFGenerator
{
    public static void CreatePersonPDF(Person person)
    {
        var htmlContent = $@"
        <html>
        <body>
            <h1>Person Information</h1>
            <p>ID: {person.Id}</p>
            <p>First Name: {person.FirstName}</p>
            <p>Last Name: {person.LastName}</p>
        </body>
        </html>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs($"Person_{person.Id}.pdf");
    }
}

class Program
{
    static void Main(string[] args)
    {
        var person = new Person
        {
            Id = 1,
            FirstName = "Iron",
            LastName = "Dev"
        };

        PDFGenerator.CreatePersonPDF(person);
    }
}

using IronPdf;

public class Person
{
    public int Id { get; init; }
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

public class PDFGenerator
{
    public static void CreatePersonPDF(Person person)
    {
        var htmlContent = $@"
        <html>
        <body>
            <h1>Person Information</h1>
            <p>ID: {person.Id}</p>
            <p>First Name: {person.FirstName}</p>
            <p>Last Name: {person.LastName}</p>
        </body>
        </html>";

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs($"Person_{person.Id}.pdf");
    }
}

class Program
{
    static void Main(string[] args)
    {
        var person = new Person
        {
            Id = 1,
            FirstName = "Iron",
            LastName = "Dev"
        };

        PDFGenerator.CreatePersonPDF(person);
    }
}

結論

要するに、C# の init キーワードは、オブジェクト初期化時に柔軟性を提供しながら、イミュータブルなオブジェクトを作成することを可能にします。 これは、プライベート set アクセサーに代わるよりクリーンで安全な選択肢であり、コンストラクターボイラープレートコードを削減します。 init キーワードを読み取り専用フィールド、構造体、および検証ロジックと組み合わせることで、読みやすさや柔軟性を損なうことなく、イミュータビリティを維持する堅牢で安全なデータ構造を構築するのに役立ちます。 IronPDF は無料トライアルを提供しており、ライセンスは$799から始まります。 これにより、PDF の編集、圧縮、およびセキュリティなどの完全な機能にアクセスできます。