跳至頁尾內容
  1. IronPDF
  2. IronPDF博客
  3. .NET 幫助
  4. C# 初始化關鍵字
.NET 幫助

C# init 關鍵字（開發者如何理解其運作方式）

Jacob Mellor，Team Iron 首席技術官
雅各·梅勒
更新:

C# 9.0 中的init關鍵字引入了一種新的定義類屬性的方法，用於創建不可變的物件。 在 C# 的早期版本中，properties 通常與 get 和 set 存取器一起使用，以從物件欄位讀取或寫入物件欄位。 但是，使用 init，您可以僅在物件初始化時使屬性可寫，之後使其成為唯讀。

本教學將以 IronPDF 函式庫的實用範例和情境，探索如何使用 C# init 關鍵字。 您也將學習到傳統的屬性設定器 (set) 與新的僅限於 init 的設定器之間的關鍵差異。

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.
$vbLabelText   $csharpLabel

C# Init Keyword (How It Works For Developers)：圖 1 - IDE 由於屬性被標記為 init-only 而產生錯誤。

在此示例中，FirstName 和 LastName 被標示為啟始專用屬性。 這表示它們只能在物件初始化時指定。 物件建立後，嘗試變更數值會導致編譯時錯誤。

為什麼要使用 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"
};
$vbLabelText   $csharpLabel

Object Initialization with Init-Only Properties

使用僅初始化屬性進行物件初始化。

使用 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
$vbLabelText   $csharpLabel

這會建立一個類型為 Point 的簡單、不可變的物件。 請注意，X 和 Y 的值是在初始化時設定的，之後不能修改。

將 init 與 Constructors 混合。

雖然 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;
    }
}
$vbLabelText   $csharpLabel

您可以同時使用構建器和 init 屬性。 此方法提供更多的彈性，同時在物件建構後仍能強制執行不可變性。

Init Over Private Set 的優點

以前，開發人員使用私有的 set accessor 來限制在類別之外的屬性修改。

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;
    }
}
$vbLabelText   $csharpLabel

儘管這種方法可行，但需要使用構建器的模板程式碼來初始化屬性。 此外，它允許類本身稍後修改屬性，這對不可變的物件來說並不總是理想的做法。 init 關鍵字消除了這個問題，因為它只允許在物件建立時進行初始化，之後的任何修改都會被阻擋。

使用唯讀欄位和初始存取器處理初始化。

init 關鍵字可以在建立物件時初始化欄位或屬性，而之後這些欄位或屬性仍保持不變。 唯讀欄位提供不變性，而 init 存取器則為屬性提供類似的功能。 這裡有兩種處理不可變性的方法：使用唯讀欄位和 init 屬性。

使用構成器的唯讀欄位

在這個範例中，我們使用 firstName 和 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
{
    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;
    }
}
$vbLabelText   $csharpLabel

使用 Init Accessor 進行初始化

另外，我們也可以使用 init 存取器來建立唯讀的屬性，這些屬性可以在物件建立時初始化，但之後就無法變更。 這樣就不需要只讀欄位，並提供更現代化的語法：

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; }
}
$vbLabelText   $csharpLabel

IronPDF 簡介

C# Init Keyword (How It Works For Developers)：圖 2 - IronPDF：C# PDF Library

IronPDF是專為 C# 開發人員設計的功能強大的 PDF 產生和處理函式庫。 它簡化了使用 PDF的工作，將 HTML、CSS、圖片和其他內容轉換成 PDF 文件。 IronPDF 具備像素完美渲染、跨平台支援以及輕鬆整合至 .NET 專案等功能，是需要快速建立高品質 PDF 的開發人員的理想選擇。 您可以在 .NET Core、Framework 和 Standard 上使用它，而且它支援多種平台，包括 Windows、Linux 和 macOS。

案例：使用 IronPDF 與 C# Init 關鍵字。

若要在 C# 專案中建立不可變的物件，同時產生 PDF，您可以結合 init 關鍵字與 IronPDF。 init 關鍵字可確保物件初始化後的完整性，而 IronPDF 則會根據該不可變模型處理資料並產生 PDF。

確保 IronPDF 在您的專案中被正確引用。 您可以透過 NuGet 安裝：

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);
    }
}
$vbLabelText   $csharpLabel

結論

C# Init Keyword (How It Works For Developers)：圖 3 - IronPDF 授權頁面。

總而言之，C# init 關鍵字允許您建立不可變的物件，同時在物件初始化時提供彈性。 它是私有集存取器的一個更乾淨、更安全的替代方案，減少了對構建器模板程式碼的需求。 將 init 關鍵字與唯讀欄位、結構及驗證邏輯相結合，可協助您建立強大且安全的資料結構，在不犧牲可讀性或彈性的情況下，保留不變性。 IronPdf 提供 免費試用，而授權費則從 $799 起。 這可讓您使用其完整功能，包括編輯、壓縮和保護 PDF。

常見問題解答

如何在C#中將HTML轉換為PDF？

您可以使用 IronPDF 的RenderHtmlAsPdf方法將 HTML 字串轉換為 PDF。您也可以使用RenderHtmlFileAsPdf將 HTML 檔案轉換為 PDF。

C# 中 init 關鍵字的用途是什麼？

`init` 關鍵字可讓您定義只能在物件初始化期間設定的屬性，從而確保物件在初始化後不可變。此功能對於創建後不應更改的物件尤其有用。

init關鍵字如何增強C#中物件的不可變性？

`init` 關鍵字允許屬性僅在物件的初始化階段設置，之後將無法進行任何更改。這保證了物件一旦創建就保持不可變狀態。

初始化屬性能否與用於產生 PDF 的程式庫一起使用？

是的，可以使用 init 屬性與 IronPDF 等庫配合使用，從不可變物件產生 PDF，從而確保用於 PDF 的資料在整個過程中保持一致。

使用 init 關鍵字來相比傳統的 setter 方法有哪些優點？

使用 init 關鍵字而不是傳統的 setter 可以提高不可變性，減少冗長的建構函式程式碼的需求，並確保物件屬性在初始化後無法修改。

如何在 C# 中將 PDF 產生與不可變屬性整合？

您可以使用 init 屬性建立不可變對象，並將這些物件傳遞給 IronPDF，IronPDF 可以利用這些資料產生一致且可靠的 PDF 文件。

init 關鍵字在創建現代 C# 應用程式時扮演什麼角色？

init 關鍵字在創建現代 C# 應用程式時發揮著至關重要的作用，它使開發人員能夠以簡潔的語法定義不可變對象，從而增強程式碼安全性並減少錯誤。

如何在 C# 專案中安裝用於產生 PDF 的庫？

您可以使用 NuGet 套件管理器在 C# 專案中安裝 IronPDF 等庫，命令如下： Install-Package IronPdf 。

為什麼應用程式開發中不可可變性如此重要？

不可變性非常重要，因為它能確保應用程式的資料完整性和一致性，從而更容易維護並降低錯誤的可能性。

init 關鍵字有哪些實際應用範例？

一個實際的例子是使用 `init` 關鍵字定義一個類，該類別的屬性只能在初始化期間設置，從而確保創建的物件保持不變。這在數據一致性至關重要的場景中尤其有用。

Jacob Mellor，Team Iron 首席技術官
雅各·梅勒
  現在就和工程團隊聊天吧
首席技術長

Jacob Mellor 是 Iron Software 的首席技術官，也是一位富有遠見的工程師，率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者，他自公司成立之初便參與塑造了其產品架構，並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年，他在倫敦創辦了自己的第一家軟體公司；2005 年，他創建了自己的第一個 .NET 元件。此後，他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次，其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長，Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新，同時指導下一代技術領導者。

相關文章

30天試用期 → 完整產品。無限制。無需信用卡。 開始免費試用