沒有找到您要找的內容嗎？
資訊圖標
跳至頁尾內容
  1. IronPDF
  2. IronPDF部落格
  3. .NET幫助
  4. C#枚舉
開發者更新

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

Jacob Mellor，首席技術官 @ Team Iron
Jacob Mellor
已更新:

正文內容： 枚舉，是列舉的簡稱，是一個強大的功能，使開發者能夠建立一組命名常數。 這些常數為值提供有意義的名稱，使程式碼更具可讀性和可維護性。 在本文中，我們將透過各種範例和解釋來探討C#中枚舉的基礎和進階概念。 我們的目標是提供對枚舉的全面理解，以及如何在您的C#應用程式中有效使用它，並使用IronPDF程式庫進行.NET中的PDF生成。

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 }
' Define an enum with four members
Friend Enum Season
	Spring
	Summer
	Autumn
	Winter
End Enum
$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 }
' 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

這行程式碼建立一個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
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()，這些方法有助於存取與每個枚舉成員關聯的整數常數。

// 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#枚舉（開發者如何使用）：圖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 }
' 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枚舉中，您可以使用位元或運算符來結合不同的權限。

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

這段程式碼將列印"It's summer."因為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);
' 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。

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");
    }
}
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#枚舉（開發者如何使用）：圖2 - 使用NuGet包管理器搜索

使用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

這個調用將生成名為WinterSalesReport.pdf的PDF文件，其中包含冬季的銷售報告。

C#枚舉（開發者如何使用）：圖3 - 使用IronPDF從程式碼範例輸出的PDF範例

結論

C#中的枚舉提供了一種型別安全的方法來處理一組相關的命名常數。 它們提高了程式碼可讀性、減少錯誤，並促進更整潔的程式碼組織。 通過將相關的常數值組合在一個有意義的名稱下，枚舉使您的程式碼更易於理解和維護。

在C#中整合IronPDF和枚舉允許基於枚舉型別動態生成PDF文件。IronPDF提供其全面的PDF工具的免費試用，提供一系列適合不同專案需求和規模的選項。

常見問題

什麼是C#中的枚舉及其用途？

枚舉（enumerations）在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文件生成中的不同類別或型別。例如，可以使用「Season」枚舉為季節銷售報告生成PDF，通過選擇適當的枚舉值動態調整內容。

如何在C#項目中安裝PDF生成程式庫？

要在C#項目中安裝PDF生成程式庫，可以使用NuGet包管理控制台並執行像Install-Package [LibraryName]的命令，或使用Visual Studio的NuGet Package Manager介面進行安裝。

如何在C#中與switch語句一起使用枚舉？

枚舉可與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核心程式碼庫的原開發者，他從創立以來就一直在塑造公司的產品架構，與首席執行官Cameron Rimington一起將公司轉變為服務於NASA、特斯拉和全球政府公司的50多名人員的公司。

Jacob擁有曼徹斯特大學的土木工程一等榮譽學士學位（BEng），於1998-2001年之間獲得。在1999年於倫敦創辦他的第一家軟體公司並於2005年建立了他的第一批.NET元組件後，他專注於解決Microsoft生態系統中的複雜問題。

他的旗艦IronPDF和Iron Suite .NET程式庫在全球獲得了超過3000萬次NuGet安裝依據，他的基礎程式碼基繼續支援著世界各地開發者使用的工具。擁有25年的商業經驗和41年的程式設計專業知識，他仍專注於推動企業級C#、Java和Python PDF技術的創新，同時指導下一代技術領導者。

相關文章

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

Iron 支援團隊

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