信息圖標
跳過到頁腳內容
  1. IronPDF
  2. IronPDF部落格
  3. .NET幫助
  4. C# 枚舉
.NET幫助

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

Jacob Mellor, Team Iron 首席技術官
Jacob Mellor
更新:

正文內容： 枚舉 (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 }
' Define an enum with four members
Friend Enum Season
	Spring
	Summer
	Autumn
	Winter
End Enum
$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 }
' Define an enum with a byte underlying type and specific values
Friend Enum Season As Byte
	Spring = 1
	Summer
	Autumn = 4
	Winter
End Enum
$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;
' Declare a Season variable and assign it an enum member value
Dim currentSeason As Season = 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
Imports System

' Convert Season.Autumn to its integer value and vice versa
Dim autumnInt As Integer = CInt(Math.Truncate(Season.Autumn)) ' autumnInt will be 4
Dim season As Season = CType(4, Season) ' 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);
}
' Get names of all enum members and print them
Dim names() As String = System.Enum.GetNames(GetType(Season))
For Each name As String In names
	Console.WriteLine(name)
Next 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 }
' Define an enum with custom integer values for members
Friend Enum ErrorCode As Integer
	None = 0
	NotFound = 404
	Unauthorized = 401
End Enum
$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 }
' Define an enum for permissions using bit flags
<Flags>
Friend Enum Permissions
	None = 0
	Read = 1
	Write = 2
	Execute = 4
End Enum
$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;
' Combine permissions using bitwise OR
Dim myPermissions As Permissions = Permissions.Read Or Permissions.Write
$vbLabelText   $csharpLabel

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

枚舉與 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;
}
' Use a switch statement with an enum
Dim season As Season = Season.Summer
Select Case season
	Case Season.Spring
		Console.WriteLine("It's spring.")
	Case Season.Summer
		Console.WriteLine("It's summer.")
	Case Season.Autumn
		Console.WriteLine("It's autumn.")
	Case Season.Winter
		Console.WriteLine("It's winter.")
End Select
$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);
' Parse a string into an enum value
Dim input As String = "Winter"
Dim season As Season = DirectCast(System.Enum.Parse(GetType(Season), input), Season)
$vbLabelText   $csharpLabel

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

在 C# 中將 IronPDF 與枚舉整合

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");
    }
}
Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

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

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

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class
$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
}
Public Enum Season
	Spring
	Summer
	Autumn
	Winter
End Enum
$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}");
    }
}
Imports IronPdf
Public Class SalesReportGenerator
	Public Shared Sub GenerateSeasonalSalesReport(ByVal season As Season)
		IronPdf.License.LicenseKey = "License-Key"
		Dim Renderer = New IronPdf.ChromePdfRenderer()
		Dim htmlTemplate = $"<h1>Sales Report for {season}</h1><p>This section contains sales data for the {season} season.</p>"
		Dim pdf = Renderer.RenderHtmlAsPdf(htmlTemplate)
		Dim outputPath = $"{season}SalesReport.pdf"
		pdf.SaveAs(outputPath)
		Console.WriteLine($"PDF report generated: {outputPath}")
	End Sub
End Class
$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);
}
Shared Sub Main(ByVal args() As String)
	SalesReportGenerator.GenerateSeasonalSalesReport(Season.Winter)
End Sub
$vbLabelText   $csharpLabel

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

C# Enums (How It Works For Developers)：圖 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, Team Iron 首席技術官
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技術的創新，同時指導下一代技術領導者。

相關文章

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

鋼鐵支援團隊

我們每週 5 天，每天 24 小時在線上。
聊天
電子郵件
打電話給我