.NET 幫助

C# 枚舉（開發者如何理解其工作原理）

Q: 如何在 C# 中宣告和初始化枚舉？

在 C# 中，枚舉型別宣告使用 enum 關鍵字，後面接著枚舉名稱及其成員。例如， enum Season { Spring, Summer, Autumn, Winter } 創建了一個名為 `Season` 的枚舉類型，包含四個成員。

Q: C# 中的枚舉成員可以擁有自訂底層值嗎？

是的，在 C# 中，您可以為枚舉成員指派特定的整數值，從而控制它們的數值表示。例如， enum ErrorCode { None = 0, NotFound = 404, Unauthorized = 401 } 為每個成員分配了自訂值。

Q: 在 C# 中，如何將枚舉值轉換為整數，反之亦然？

若要將枚舉值轉換為整數，請使用型別轉換，例如 (int)Season.Autumn 。若要將整數轉換為枚舉，請將整數強制轉換為枚舉類型，例如 (Season)4 。

Q: 在 C# 專案中安裝 PDF 生成庫的步驟是什麼？

若要在 C# 專案中安裝 PDF 產生庫，可以使用 NuGet 套件管理器控制台，並執行類似 Install-Package [LibraryName] 命令，或使用 Visual Studio 的 NuGet 套件管理器介面進行安裝。

Q: 如何在 C# 中將字串解析為枚舉類型？

在 C# 中，可以使用 Enum.Parse() 方法將字串解析為枚舉值。例如， Enum.Parse(typeof(Season), "Winter") 會將字串 'Winter' 轉換為其對應的枚舉值 'Season.Winter'。

Q: C#中有哪些方法可以用來處理枚舉名稱？

C# 提供了諸如 Enum.GetName() 和 Enum.GetNames() 之類的方法來處理枚舉名稱。 Enum.GetName Enum.GetName() 傳回具有指定值的常數的名稱，而 Enum.GetNames() 傳回一個包含枚舉中所有常數名稱的陣列。

雅各·梅勒

更新:7月 28, 2025

正文內容：枚舉 (Enums) 是枚數 (enumerations) 的縮寫，是一種強大的功能，可讓開發人員建立一組已命名的常量。這些常數透過為數值提供有意義的名稱，使程式碼更具可讀性和可維護性。在本文中，我們將透過各種範例和說明，探討 C# 中枚舉的基礎和進階概念。我們的目標是讓您全面了解枚舉，以及如何在您的 C# 應用程式中有效地使用 IronPDF 函式庫在 .NET 中產生 PDF 。

C#中的枚舉簡介；

枚举是 C# 中的一种值类型，可使变量成为一组预定义的常量，每个常量称为一个枚举成员。 enum 關鍵字用於宣告枚舉類型，提供在單一名稱下將常量值歸類的方法。枚舉提高了程式碼的可讀性，並減少了因傳遞不正確的值而造成的錯誤。

// Define an enum with four members
enum Season { Spring, Summer, Autumn, Winter }

// Define an enum with four members
enum Season { Spring, Summer, Autumn, Winter }

$vbLabelText $csharpLabel

在上述程式碼中，Season 是一個具有四個成員的枚舉類型：Spring、Summer、Autumn 和 Winter。透過定義這個枚數，我們現在可以建立類型為 Season 的變數，這些變數只能持有這四個值中的一個。

枚举的基本类型

瞭解 Enum 元件的整數值

C# 中枚举的底层类型默认为 int，称为底层积分类型，枚举成员的整数值从 0 开始，除非明确指定，否则每个成员的整数值在前一个成员的基础上递增 1。您也可以將枚举的底層類型定義為任何其他整體類型。

// Define an enum with a byte underlying type and specific values
enum Season : byte { Spring = 1, Summer, Autumn = 4, Winter }

// Define an enum with a byte underlying type and specific values
enum Season : byte { Spring = 1, Summer, Autumn = 4, Winter }

$vbLabelText $csharpLabel

在這個範例中，Season 枚舉以 byte 作為其基本類型。 Spring 明確指定值為 1，使其成為預設值，而 Summer、Autumn 和 Winter 則根據其順序指定相應值。

在您的程式碼中使用枚舉

要使用枚举，您只需声明一个指定枚举类型的变量，并使用点语法为其分配一个枚举值，例如在枚举声明中定义的不同值之一。

// Declare a Season variable and assign it an enum member value
Season currentSeason = Season.Autumn;

// Declare a Season variable and assign it an enum member value
Season currentSeason = Season.Autumn;

$vbLabelText $csharpLabel

這一行會建立一個類型為 Season 的變數 currentSeason，並賦予其值 Autumn。這可清楚說明 currentSeason 只能持有有效 Season 的值。

枚舉值與整數之間的轉換

您可以使用轉換 (casting) 將枚數值轉換為相對應的整數值，反之亦然。當您需要以數字形式儲存或傳輸資料時，這將非常有用。

// Convert Season.Autumn to its integer value and vice versa
int autumnInt = (int)Season.Autumn;     // autumnInt will be 4
Season season = (Season)4;              // season will be Season.Autumn

// Convert Season.Autumn to its integer value and vice versa
int autumnInt = (int)Season.Autumn;     // autumnInt will be 4
Season season = (Season)4;              // season will be Season.Autumn

$vbLabelText $csharpLabel

在此，autumnInt 的值為 4，對應於 Season 枚舉中的 Autumn。相反地，當將整數 4 投回 Season 時，season 將設定為 Autumn。

使用枚舉方法工作

C# 提供了多種處理枚舉的方法，例如 Enum.GetName()、Enum.GetNames()、Enum.GetValue() 和 Enum.GetValues()，這些方法對於存取與每個枚舉成員相關的 int 常數非常有用。

// Get names of all enum members and print them
string[] names = Enum.GetNames(typeof(Season));
foreach (string name in names)
{
    Console.WriteLine(name);
}

// Get names of all enum members and print them
string[] names = Enum.GetNames(typeof(Season));
foreach (string name in names)
{
    Console.WriteLine(name);
}

$vbLabelText $csharpLabel

C# Enums (How It Works For Developers)：圖 1 - 與 Season enum 相關聯的每個值的控制台輸出。

此程式碼片段會列印 Season 枚舉中所有成員的名稱。這些方法對於遍歷枚舉的所有可能值或在字串表示法與枚舉值之間進行轉換非常有用。

為枚舉成員指定特定值

您可以為枚舉成員指定特定的整數值，以明確控制其數值。

// Define an enum with custom integer values for members
enum ErrorCode : int { None = 0, NotFound = 404, Unauthorized = 401 }

// Define an enum with custom integer values for members
enum ErrorCode : int { None = 0, NotFound = 404, Unauthorized = 401 }

$vbLabelText $csharpLabel

在這個範例中，ErrorCode 是一個枚數，每個成員都指定了自訂的整數值。這對於預先定義的數字代碼非常有用，例如 HTTP 狀態代碼。

使用枚举作为位标志

透過使用 [Flags]屬性，您可以將一個枚舉定義為一組位標誌。這可讓您在單一枚举變數中儲存數值組合。

[Flags]
// Define an enum for permissions using bit flags
enum Permissions { None = 0, Read = 1, Write = 2, Execute = 4 }

[Flags]
// Define an enum for permissions using bit flags
enum Permissions { None = 0, Read = 1, Write = 2, Execute = 4 }

$vbLabelText $csharpLabel

透過上述定義的 Permissions 枚舉，您可以使用 bitwise OR 運算符結合不同的權限。

// Combine permissions using bitwise OR
Permissions myPermissions = Permissions.Read | Permissions.Write;

// Combine permissions using bitwise OR
Permissions myPermissions = Permissions.Read | Permissions.Write;

$vbLabelText $csharpLabel

這將 myPermissions 設定為 Read 和 Write 權限的組合。

枚举和开关语句

枚举与 switch 语句配合得非常好，允许您根据枚举的值执行不同的代码块。

// Use a switch statement with an enum
Season season = Season.Summer;
switch (season)
{
    case Season.Spring:
        Console.WriteLine("It's spring.");
        break;
    case Season.Summer:
        Console.WriteLine("It's summer.");
        break;
    case Season.Autumn:
        Console.WriteLine("It's autumn.");
        break;
    case Season.Winter:
        Console.WriteLine("It's winter.");
        break;
}

// Use a switch statement with an enum
Season season = Season.Summer;
switch (season)
{
    case Season.Spring:
        Console.WriteLine("It's spring.");
        break;
    case Season.Summer:
        Console.WriteLine("It's summer.");
        break;
    case Season.Autumn:
        Console.WriteLine("It's autumn.");
        break;
    case Season.Winter:
        Console.WriteLine("It's winter.");
        break;
}

$vbLabelText $csharpLabel

由於 season 變數設定為 Season.Summer，因此此程式碼將列印"It's summer."。

將字串解析為枚舉類型

C# 允許您使用 Enum.Parse() 方法解析字串以取得對應的枚舉值。

// Parse a string into an enum value
string input = "Winter";
Season season = (Season)Enum.Parse(typeof(Season), input);

// Parse a string into an enum value
string input = "Winter";
Season season = (Season)Enum.Parse(typeof(Season), input);

$vbLabelText $csharpLabel

此程式碼將字串 "Winter" 轉換為其對應的枚舉值 Season.Winter。

在 C# 中整合 IronPDF 與 Enums;。

IronPDF PDF Library for Dynamic Document Generation 是適用於 .NET 應用程式的 PDF 函式庫，可協助開發人員輕鬆建立、編輯和處理 PDF 文件。這個功能強大的函式庫在需要動態產生 PDF 的情境中特別有用，例如產生報告或發票。在本節中，我們將探討如何將 IronPDF 與 C# 枚舉相整合，以在 .NET 中從 HTML 創建 PDF 報告，我們還將介紹 IronPDF 在專案中的安裝過程。

使用 IronPDF，您可以將任何 HTML、URL 或網頁轉換成 PDF，且外觀與原始碼一模一樣。它是為發票、報告和其他網頁內容產生 PDF 的絕佳選擇。準備好將 HTML 轉換為 PDF 嗎？ IronPdf 讓您毫不費力。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

$vbLabelText $csharpLabel

安裝 IronPDF。

使用 NuGet 包管理器控制台安裝 IronPDF 非常簡單。在 Visual Studio 中打開套件管理員控制台，並寫下以下指令：

Install-Package IronPdf

此指令將在我們的專案中安裝 IronPdf。

另一種方法是利用 Visual Studio 在專案中安裝 IronPdf。在 Visual Studio 中，右鍵按一下解決方案探索器，然後按一下 NuGet Package Manager for Solutions。之後，按一下左側的瀏覽索引標籤。然後搜尋 IronPDF，點擊安裝，並將其添加到您的專案中。

C# Enums (How It Works For Developers)：圖 2 - 使用 NuGet 套件管理程式搜尋 "IronPDF" 安裝 IronPDF

使用 IronPDF 與枚舉。

讓我們考慮一個情況：您想要產生一份 PDF 文件，其中包含一份季節性銷售資料的報告。您可以使用枚數來表示不同的季節，並使用 IronPDF 來產生 PDF 報告。首先，為季節定義一個枚舉：

public enum Season
{
    Spring,
    Summer,
    Autumn,
    Winter
}

public enum Season
{
    Spring,
    Summer,
    Autumn,
    Winter
}

$vbLabelText $csharpLabel

接下來，我們要寫一個方法，根據選定的季節產生 PDF 報告。本方法將利用 IronPDF 建立一個簡單的 PDF 文件，概述特定季節的銷售資料。

using IronPdf;
public class SalesReportGenerator
{
    public static void GenerateSeasonalSalesReport(Season season)
    {
        IronPdf.License.LicenseKey = "License-Key";
        var Renderer = new IronPdf.ChromePdfRenderer();
        var htmlTemplate = $"<h1>Sales Report for {season}</h1><p>This section contains sales data for the {season} season.</p>";
        var pdf = Renderer.RenderHtmlAsPdf(htmlTemplate);
        var outputPath = $@"{season}SalesReport.pdf";
        pdf.SaveAs(outputPath);
        Console.WriteLine($"PDF report generated: {outputPath}");
    }
}

using IronPdf;
public class SalesReportGenerator
{
    public static void GenerateSeasonalSalesReport(Season season)
    {
        IronPdf.License.LicenseKey = "License-Key";
        var Renderer = new IronPdf.ChromePdfRenderer();
        var htmlTemplate = $"<h1>Sales Report for {season}</h1><p>This section contains sales data for the {season} season.</p>";
        var pdf = Renderer.RenderHtmlAsPdf(htmlTemplate);
        var outputPath = $@"{season}SalesReport.pdf";
        pdf.SaveAs(outputPath);
        Console.WriteLine($"PDF report generated: {outputPath}");
    }
}

$vbLabelText $csharpLabel

在這個範例中，我們定義了一個方法 GenerateSeasonalSalesReport，這個方法會將 Season 枚舉當成參數。它使用 IronPDF 的 ChromePdfRenderer 類別，從包含季節名稱和銷售資料佔位符文字的 HTML 字串產生 PDF。然後以包含季節名稱的檔案名稱儲存 PDF。

執行

若要產生季節性銷售報告，請使用特定季節呼叫 GenerateSeasonalSalesReport 方法：

static void Main(string[] args)
{
    SalesReportGenerator.GenerateSeasonalSalesReport(Season.Winter);
}

static void Main(string[] args)
{
    SalesReportGenerator.GenerateSeasonalSalesReport(Season.Winter);
}

$vbLabelText $csharpLabel

此呼叫會產生一個 PDF 文件，名為 WinterSalesReport.pdf，其中包含冬季的銷售報告。

C# Enums (How It Works For Developers)：圖 3 - 使用 IronPDF 的 PDF 輸出範例，來自程式碼範例。

結論

C# 中的枚举提供了一种类型安全的方式来处理相关命名常量集。這些工具可增強程式碼的可讀性、減少錯誤，並有助於更乾淨的程式碼組織。透過將相關的常數值組合在一個有意義的名稱下，枚舉可以讓您的程式碼更容易理解和維護。

將 IronPDF 與 C# 中的枚舉結合，可根據枚舉類型動態生成 PDF 文件。IronPDF 提供免費試用其全面的 PDF 工具，提供一系列選項以符合不同的專案需求和規模。

常見問題解答

C# 中的枚舉是什麼？它們有什麼用？

枚舉（Enums，即枚舉的縮寫）是 C# 中的一項特性，它允許開發人員定義一組命名常數。這提高了程式碼的可讀性和可維護性，因為它將常數值分組到一個名稱下。

如何在 C# 中宣告和初始化枚舉？

在 C# 中，枚舉型別宣告使用enum關鍵字，後面接著枚舉名稱及其成員。例如， enum Season { Spring, Summer, Autumn, Winter }創建了一個名為 `Season` 的枚舉類型，包含四個成員。

C# 中的枚舉成員可以擁有自訂底層值嗎？

是的，在 C# 中，您可以為枚舉成員指派特定的整數值，從而控制它們的數值表示。例如， enum ErrorCode { None = 0, NotFound = 404, Unauthorized = 401 }為每個成員分配了自訂值。

在 C# 中，如何將枚舉值轉換為整數，反之亦然？

若要將枚舉值轉換為整數，請使用型別轉換，例如(int)Season.Autumn 。若要將整數轉換為枚舉，請將整數強制轉換為枚舉類型，例如(Season)4 。

C# 枚舉中的 [Flags] 特性有什麼用途？

C# 中的 [Flags] 特性允許將枚舉用作一組位元標誌，從而可以在單一變數中組合不同的值。這對於需要同時表示多個值的場景非常有用，例如組合「讀取」和「寫入」權限。

如何在 C# 中利用枚舉產生動態 PDF 文件？

枚舉可用於在動態 PDF 文件產生中表示不同的類別或類型。例如，可以使用「季節」枚舉，透過選擇相應的枚舉值來動態調整內容，從而建立季節性銷售報告的 PDF 文件。

在 C# 專案中安裝 PDF 生成庫的步驟是什麼？

若要在 C# 專案中安裝 PDF 產生庫，可以使用 NuGet 套件管理器控制台，並執行類似Install-Package [LibraryName]命令，或使用 Visual Studio 的 NuGet 套件管理器介面進行安裝。

如何在 C# 中使用 switch 語句實現枚舉？

枚舉類型可以與 switch 語句結合使用，根據枚舉值執行不同的程式碼區塊。例如，對「季節」枚舉變數使用 switch 語句，可以針對每個季節執行特定的邏輯，從而提高程式碼的清晰度和組織性。

如何在 C# 中將字串解析為枚舉類型？

在 C# 中，可以使用Enum.Parse()方法將字串解析為枚舉值。例如， Enum.Parse(typeof(Season), "Winter")會將字串 'Winter' 轉換為其對應的枚舉值 'Season.Winter'。

C#中有哪些方法可以用來處理枚舉名稱？

C# 提供了諸如Enum.GetName()和Enum.GetNames()之類的方法來處理枚舉名稱。 Enum.GetName Enum.GetName()傳回具有指定值的常數的名稱，而Enum.GetNames()傳回一個包含枚舉中所有常數名稱的陣列。

雅各·梅勒

現在就和工程團隊聊天吧

首席技術長

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 技術的創新，同時指導下一代技術領導者。

C# 參數（開發者如何理解其工作原理）

.NET NuGet（開發者使用指南）

客戶亮點：

開發者對焦：

網路研討會：

C# 枚舉（開發者如何理解其工作原理）

C#中的枚舉簡介；

枚举的基本类型

瞭解 Enum 元件的整數值

在您的程式碼中使用枚舉

枚舉值與整數之間的轉換

使用枚舉方法工作

為枚舉成員指定特定值

使用枚举作为位标志

枚举和开关语句

將字串解析為枚舉類型

在 C# 中整合 IronPDF 與 Enums;。

安裝 IronPDF。

使用 IronPDF 與枚舉。

執行

結論

常見問題解答

C# 中的枚舉是什麼？它們有什麼用？

如何在 C# 中宣告和初始化枚舉？

C# 中的枚舉成員可以擁有自訂底層值嗎？

在 C# 中，如何將枚舉值轉換為整數，反之亦然？

C# 枚舉中的 [Flags] 特性有什麼用途？

如何在 C# 中利用枚舉產生動態 PDF 文件？

在 C# 專案中安裝 PDF 生成庫的步驟是什麼？

如何在 C# 中使用 switch 語句實現枚舉？

如何在 C# 中將字串解析為枚舉類型？

C#中有哪些方法可以用來處理枚舉名稱？

C# 枚舉（開發者如何理解其工作原理）

C#中的枚舉簡介；

枚举的基本类型

瞭解 Enum 元件的整數值

在您的程式碼中使用枚舉

枚舉值與整數之間的轉換

使用枚舉方法工作

為枚舉成員指定特定值

使用枚举作为位标志

枚举和开关语句

將字串解析為枚舉類型

在 C# 中整合 IronPDF 與 Enums;。

安裝 IronPDF。

使用 IronPDF 與枚舉。

執行

結論

常見問題解答

C# 中的枚舉是什麼？它們有什麼用？

如何在 C# 中宣告和初始化枚舉？

C# 中的枚舉成員可以擁有自訂底層值嗎？

在 C# 中，如何將枚舉值轉換為整數，反之亦然？

C# 枚舉中的 [Flags] 特性有什麼用途？

如何在 C# 中利用枚舉產生動態 PDF 文件？

在 C# 專案中安裝 PDF 生成庫的步驟是什麼？

如何在 C# 中使用 switch 語句實現枚舉？

如何在 C# 中將字串解析為枚舉類型？

C#中有哪些方法可以用來處理枚舉名稱？

相關文章

連結 CLI 的簡潔性和 .NET：將 Curl DotNet 與 IronPDF 結合使用

C# 隨機數產生器

C# 字串相等運算子（開發者使用方法）

下一步：開始30天免費試用

下一步：開始30天免費試用

深受全球數百萬工程師信賴