.NET幫助

C# Enum（對於開發者的運行原理）

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.GetNames() 返回枚舉中所有常量的名稱數組。

Jacob Mellor

更新:2025年7月28日

正文內容：枚舉（Enums）是枚舉（numerations）的縮寫，它是一項強大的功能，使開發人員能夠建立一組命名常數。這些常數透過為值提供有意義的名稱，使程式碼更易讀、更易於維護。本文將透過各種範例和解釋，探討 C# 中列舉的基礎知識和高階概念。我們的目標是全面了解枚舉，以及如何在.NET中使用IronPDF庫生成 PDF 時，在 C# 應用程式中有效地使用枚舉。

Introduction to Enum in 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類型的變量，每個變數只能保存這四個值中的一個。

枚舉的底層類型

理解枚舉成員的整數值

預設情況下，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枚舉的底層類型是位元組。春季被明確賦予值 1，使其成為預設值，而夏季、秋季和冬季則根據其順序被賦予相應的值。

在程式碼中使用枚舉

要使用枚舉，只需聲明一個指定枚舉類型的變量，並使用點語法為其賦值枚舉值，例如枚舉聲明中定義的不同值之一。

// 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

這行程式碼建立了一個名為currentSeason的Season類型的變量，並將其值賦為Autumn 。這表明currentSeason只能包含有效的Season值。

枚舉值與整數之間的轉換

您可以使用類型轉換將枚舉值轉換為其對應的整數值，反之亦然。當您需要以數位形式儲存或傳輸資料時，這非常有用。

// 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 類型時，季節將被設定為秋季。

使用枚舉方法

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# 枚舉(開發者使用方法)：圖 1 - 與 Season 枚舉關聯的每個值的控制台輸出

這段程式碼片段會列印出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

透過上述定義的權限枚舉，您可以使用位元或運算子組合不同的權限。

// 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設定為讀取和寫入權限的組合。

枚舉和 switch 語句

枚舉類型與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 。

將字串解析為枚舉

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 。

Integrating IronPDF with Enums in C

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套件管理器"。之後，點選左側的瀏覽標籤。然後，搜尋IronPDF，點擊安裝，並將其新增至您的專案。

C# 枚舉(開發者使用方法)：圖 2 - 使用NuGet套件管理器搜尋

將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

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

C# 枚舉（開發者使用方法）：圖 3 - 使用IronPDF產生的 PDF 範例（來自範例程式碼）

結論

C# 中的枚舉提供了一種型別安全的方式來處理一組相關的命名常數。它們可以提高程式碼可讀性，減少錯誤，並有助於更清晰地組織程式碼。枚舉透過將相關的常數值分組到一個有意義的名稱下，使你的程式碼更容易理解和維護。

將IronPDF與 C# 中的枚舉類型集成，可以基於枚舉類型動態生成 PDF 文件。 IronPDF 提供功能全面的 PDF 工具的免費試用版，並提供多種選項以滿足不同專案需求和規模。

常見問題解答

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

枚舉是 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] 屬性允許枚舉作為一組位標誌使用，從而在單個變量中組合值。這對於需要一起表示多個值的場景非常有用，例如結合 'Read' 和 'Write' 權限。

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

枚舉可用於動態 PDF 文檔生成中表示不同的類別或類型。例如，可以使用 'Season' 枚舉來創建季節性銷售報告的 PDF，通過選擇合適的枚舉值動態調整內容。

在 C# 項目中安裝 PDF 生成庫的過程是什麼？

要在 C# 項目中安裝 PDF 生成庫，使用 NuGet 包管理器控制台執行類似 Install-Package [LibraryName] 的命令，或使用 Visual Studio 的 NuGet 包管理器界面進行安裝。

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

在 C# 中，可以將枚舉與 switch 語句一起使用，以根據枚舉的值執行不同的代碼塊。例如，針對 'Season' 枚舉變量的 switch 語句可以為每個季節執行特定的邏輯，從而增強代碼清晰度和組織性。

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

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

在 C# 中，可以使用哪些方法來操作枚舉名稱？

C# 提供了諸如 Enum.GetName() 和 Enum.GetNames() 這樣的方法來操作枚舉名稱。Enum.GetName() 返回具有指定值的常量的名稱，Enum.GetNames() 返回枚舉中所有常量的名稱數組。

Jacob Mellor

立即與工程團隊聊天

首席技術官

Jacob Mellor是Iron Software的首席技術官，也是開創C# PDF技術的前瞻性工程師。作為Iron Software核心代碼庫的原始開發者，他自公司成立以來就塑造了公司的產品架構，並與CEO Cameron Rimington將公司轉型為服務NASA、Tesla以及全球政府機構的50多人公司。

Jacob擁有曼徹斯特大學土木工程一級榮譽學士學位（1998年–2001年）。他於1999年在倫敦開立首家軟體公司，並於2005年建立了他的第一個.NET組件，專注於解決Microsoft生態系統中的複雜問題。

他的旗艦作品IronPDF和Iron Suite .NET程式庫全球已獲得超過3000萬次NuGet安裝，他的基礎代碼不斷在全球各地驅動開發者工具。擁有25年以上的商業經驗和41年的編碼專業知識，Jacob仍然專注於推動企業級C#、Java和Python PDF技術的創新，同時指導下一代技術領導者。

更新2026年2月20日

銜接 CLI 簡化與 .NET : 使用 Curl DotNet 與 IronPDF for .NET

Jacob Mellor 藉由 CurlDotNet 彌補了這方面的不足，CurlDotNet 是為了讓 .NET 生態系統能熟悉 cURL 而建立的函式庫。

更新2025年12月20日

RandomNumberGenerator C#

使用RandomNumberGenerator C#類可以幫助將您的PDF生成和編輯項目提升至新水準

更新2025年12月20日

C#字符串等於（它如何對開發者起作用）

當結合使用強大的PDF庫IronPDF時，開關模式匹配可以讓您構建更智能、更清晰的邏輯來進行文檔處理

C# Params（對於開發者的運行原理）

Dotnet NuGet（對於開發者的�...

客戶亮點：

開發者焦點：

網路研討會：

立即開始30天免費試用

C# Enum（對於開發者的運行原理）

Introduction to Enum in C

枚舉的底層類型

理解枚舉成員的整數值

在程式碼中使用枚舉

枚舉值與整數之間的轉換

使用枚舉方法

為枚舉成員指派特定值

使用枚舉作為位標誌

枚舉和 switch 語句

將字串解析為枚舉

Integrating IronPDF with Enums in C

安裝IronPDF

將IronPDF與枚舉類型結合使用

執行

結論

常見問題解答

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

如何在 C# 中聲明和初始化枚舉？

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

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

C# 枚舉中 [Flags] 屬性的用途是什麼？

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

在 C# 項目中安裝 PDF 生成庫的過程是什麼？

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

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

在 C# 中，可以使用哪些方法來操作枚舉名稱？

Iron Support Team

立即開始30天免費試用

C# Enum（對於開發者的運行原理）

Introduction to Enum in C

枚舉的底層類型

理解枚舉成員的整數值

在程式碼中使用枚舉

枚舉值與整數之間的轉換

使用枚舉方法

為枚舉成員指派特定值

使用枚舉作為位標誌

枚舉和 switch 語句

將字串解析為枚舉

Integrating IronPDF with Enums in C

安裝IronPDF

將IronPDF與枚舉類型結合使用

執行

結論

常見問題解答

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

如何在 C# 中聲明和初始化枚舉？

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

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

C# 枚舉中 [Flags] 屬性的用途是什麼？

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

在 C# 項目中安裝 PDF 生成庫的過程是什麼？

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

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

在 C# 中，可以使用哪些方法來操作枚舉名稱？

相關文章

銜接 CLI 簡化與 .NET : 使用 Curl DotNet 與 IronPDF for .NET

RandomNumberGenerator C#

C#字符串等於（它如何對開發者起作用）

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

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

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

Iron Support Team