C# Named Tuples (How it Works for Developers)

什麼是命名元組？

C# 中的元組是一種輕量級資料結構，允許將多個值組合成一個物件。 C# 7.0 中引入的命名元組進一步擴展了這個概念，讓您可以為每個值添加標籤，從而使您的程式碼更易讀、更易於維護。 元組字面量與命名元組非常相似，所以一定要注意不要將兩者混淆。 雖然元組字面量是另一種儲存資料的簡單方法，但由於元組包含未命名的元素，因此存取效率可能較低。

使用命名元組，可以輕鬆地將多個資料元素儲存在一起，從而提供一種輕量級、易於存取的變數處理方法。 在處理複雜的資料結構時，元組可能會變得難以管理，但您可以繼續閱讀，學習如何像專業人士一樣使用元組，從而避免這種情況。

例如，命名元組允許您按名稱引用元組字段，而不是按索引存取元素。 這有助於提高程式碼的清晰度，尤其是在處理複雜資料時。 請記住，在使用元組語法定義變數時，使用駝峰命名法是一種良好的實踐。

// Declaration of a named tuple
(string firstName, string lastName, int age) person = ("Jane", "Doe", 25);

// Printing the tuple values to the console
Console.WriteLine($"Name: {person.firstName} {person.lastName}, Age: {person.age}");

// Declaration of a named tuple
(string firstName, string lastName, int age) person = ("Jane", "Doe", 25);

// Printing the tuple values to the console
Console.WriteLine($"Name: {person.firstName} {person.lastName}, Age: {person.age}");

C# 命名元組（開發者如何理解）：圖 1

在 C# 應用程式中使用命名元組的好處

在 C# 應用程式中，命名元組具有以下幾個優點：

*提高了程式碼清晰度：*您可以改用person.firstName或person.lastName而不是person.Item1這樣的索引，這樣您的程式碼會更直觀。 無需定義完整的類別：**命名元組非常適合在不想定義完整類別時臨時將資料分組。 *適用於資料驅動型應用：在處理結構化資料（如報表或資料處理）時，命名元組提供了組織和操作資訊的有效方法。

以下範例展示了命名元組如何簡化報表場景中的資料處理：

// Using named tuples for reporting purposes
(string reportName, DateTime reportDate, decimal totalSales) salesReport = ("Q3 Sales Report", DateTime.Now, 15000.75m);

// Print the report details using the named tuple
Console.WriteLine($"{salesReport.reportName} generated on {salesReport.reportDate} with total sales: {salesReport.totalSales:C}");

// Using named tuples for reporting purposes
(string reportName, DateTime reportDate, decimal totalSales) salesReport = ("Q3 Sales Report", DateTime.Now, 15000.75m);

// Print the report details using the named tuple
Console.WriteLine($"{salesReport.reportName} generated on {salesReport.reportDate} with total sales: {salesReport.totalSales:C}");

C# 命名元組（開發者如何理解）：圖 2

使用命名元組：語法和範例

若要建立命名元組，請為每個元素定義一個特定類型和一個欄位名稱：

(string productName, int id, decimal price) product = ("Laptop", 5, 799.99m);

(string productName, int id, decimal price) product = ("Laptop", 5, 799.99m);

取得這些值非常簡單：

// Print product details using named tuple
Console.WriteLine($"Product: {product.productName}, Product ID: #{product.id}, Price: {product.price:C}");

// Print product details using named tuple
Console.WriteLine($"Product: {product.productName}, Product ID: #{product.id}, Price: {product.price:C}");

C# 命名元組（開發者使用指南）：圖 3 - 控制台輸出 - 命名元組數據

命名元組非常適合將相關資訊分組，例如使用者詳細資料、訂單資訊或報表資料。

在 .NET 專案中設定 IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

使用 IronPDF 從命名元組數據生成 PDF

IronPDF 讓您無縫地將結構化資料轉換為 PDF 檔案。 您可以將命名元組與 IronPDF 結合使用，產生動態內容，例如發票或報表。 以下是如何將客戶資料儲存在命名元組中並使用 IronPDF 產生 PDF 的方法：

using IronPdf;

(string customerName, decimal orderTotal, DateTime orderDate) order = ("Jane Smith", 199.99m, DateTime.Now);

// Create HTML content using named tuple data
string htmlContent = $@"
<h1>Order Invoice</h1>
<p>Customer: {order.customerName}</p>
<p>Order Total: {order.orderTotal:C}</p>
<p>Order Date: {order.orderDate:d}</p>";

// Convert HTML to PDF using IronPDF's ChromePdfRenderer
ChromePdfRenderer Renderer = new ChromePdfRenderer();
PdfDocument pdf = Renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice.pdf");

using IronPdf;

(string customerName, decimal orderTotal, DateTime orderDate) order = ("Jane Smith", 199.99m, DateTime.Now);

// Create HTML content using named tuple data
string htmlContent = $@"
<h1>Order Invoice</h1>
<p>Customer: {order.customerName}</p>
<p>Order Total: {order.orderTotal:C}</p>
<p>Order Date: {order.orderDate:d}</p>";

// Convert HTML to PDF using IronPDF's ChromePdfRenderer
ChromePdfRenderer Renderer = new ChromePdfRenderer();
PdfDocument pdf = Renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice.pdf");

C# 命名元組（開發者使用方法）：圖 5 - 輸出 PDF - 使用命名元組資料建立 PDF 發票

在這個例子中，建立了一個名為order的命名元組，並用它來產生 HTML 內容，然後使用 IronPDF 的功能將其轉換為 PDF。 使用ChromePdfRenderer類， RenderHtmlAsPdf方法將 HTML 內容渲染成 PDF 文檔，然後使用SaveAs方法儲存該文檔。

範例：使用命名元組進行資料組織的 PDF 報告

假設你想為多個用戶產生一份報告，將他們的資訊儲存在命名元組中，然後使用 IronPDF 將這些數據轉換為 PDF 報告。 以下是一個實際例子：

using IronPdf;
using System.Collections.Generic;

var userList = new List<(string Name, int Age, string Email)>
{
    ("Alice", 30, "alice@example.com"),
    ("Bob", 25, "bob@example.com"),
    ("Charlie", 35, "charlie@example.com")
};

string htmlReport = "<h1>User Report</h1><ul>";

// Loop through the list of named tuples to generate report content
foreach (var user in userList)
{
    htmlReport += $"<li>Name: {user.Name}, Age: {user.Age}, Email: {user.Email}</li>";
}
htmlReport += "</ul>";

// Convert the HTML report to PDF
ChromePdfRenderer Renderer = new ChromePdfRenderer();
PdfDocument pdf = Renderer.RenderHtmlAsPdf(htmlReport);
pdf.SaveAs("user_report.pdf");

using IronPdf;
using System.Collections.Generic;

var userList = new List<(string Name, int Age, string Email)>
{
    ("Alice", 30, "alice@example.com"),
    ("Bob", 25, "bob@example.com"),
    ("Charlie", 35, "charlie@example.com")
};

string htmlReport = "<h1>User Report</h1><ul>";

// Loop through the list of named tuples to generate report content
foreach (var user in userList)
{
    htmlReport += $"<li>Name: {user.Name}, Age: {user.Age}, Email: {user.Email}</li>";
}
htmlReport += "</ul>";

// Convert the HTML report to PDF
ChromePdfRenderer Renderer = new ChromePdfRenderer();
PdfDocument pdf = Renderer.RenderHtmlAsPdf(htmlReport);
pdf.SaveAs("user_report.pdf");

C# 命名元組（開發者使用方法）：圖 6 - 輸出 PDF - 使用元組和 foreach 迴圈的使用者報告範例

在這個例子中，建立了一個包含多個命名元組的清單。 foreach 迴圈用於遍歷列表，並將資料動態地附加到 HTML 報告內容中，然後將其轉換為 PDF。

結合命名元組和循環實現高效的 PDF 生成

命名元組與循環結合使用時特別有用，例如，可以為一系列訂單建立單獨的發票，從而產生多個 PDF 文件。 以下是如何遍歷命名元組列表並為每個條目產生 PDF 的方法：

using IronPdf;
using System.Collections.Generic;

var orders = new List<(string customerName, decimal orderTotal, DateTime orderDate)>
{
    ("Alice", 120.50m, DateTime.Now),
    ("Bob", 85.75m, DateTime.Now),
    ("Charlie", 199.99m, DateTime.Now)
};

// Iterate through the list of orders and generate a PDF for each
foreach (var order in orders)
{
    string htmlContent = $@"
        <h1>Order Invoice</h1>
        <p>Customer: {order.customerName}</p>
        <p>Order Total: {order.orderTotal:C}</p>
        <p>Order Date: {order.orderDate:d}</p>";

    ChromePdfRenderer Renderer = new ChromePdfRenderer();
    PdfDocument pdf = Renderer.RenderHtmlAsPdf(htmlContent);
    pdf.SaveAs($"{order.customerName}_invoice.pdf");
}

using IronPdf;
using System.Collections.Generic;

var orders = new List<(string customerName, decimal orderTotal, DateTime orderDate)>
{
    ("Alice", 120.50m, DateTime.Now),
    ("Bob", 85.75m, DateTime.Now),
    ("Charlie", 199.99m, DateTime.Now)
};

// Iterate through the list of orders and generate a PDF for each
foreach (var order in orders)
{
    string htmlContent = $@"
        <h1>Order Invoice</h1>
        <p>Customer: {order.customerName}</p>
        <p>Order Total: {order.orderTotal:C}</p>
        <p>Order Date: {order.orderDate:d}</p>";

    ChromePdfRenderer Renderer = new ChromePdfRenderer();
    PdfDocument pdf = Renderer.RenderHtmlAsPdf(htmlContent);
    pdf.SaveAs($"{order.customerName}_invoice.pdf");
}

C# 命名元組（開發者使用指南）：圖 7 - 輸出 PDF - 發票範例

在這個例子中，使用了一個由多個元組組成的列表，當遍歷該列表時，會為每個元組建立一個新的 PDF 文件。 在需要為特定數據產生單獨的發票或報告的情況下，這尤其有用。

使用命名元組處理動態資料和自訂 PDF 模板

命名元組也可以用於將資料動態填入自訂 HTML 範本中。 例如，您可以將資料儲存在命名元組中，並在將 HTML 模板轉換為 PDF 之前將該資料插入 HTML 模板中：

using IronPdf;
using System.IO;

// Define a single named tuple with product data
(string productName, decimal price, int count) product = ("Laptop", 799.99m, 5);

// Read the HTML template from a file
string htmlTemplate = File.ReadAllText("template.html");

// Replace placeholders in the template with values from the named tuple
string filledTemplate = htmlTemplate
    .Replace("{0}", product.productName)
    .Replace("{1:C}", product.price.ToString("C"))
    .Replace("{2}", product.count.ToString());

// Convert the filled template to PDF
ChromePdfRenderer Renderer = new ChromePdfRenderer();
PdfDocument pdf = Renderer.RenderHtmlAsPdf(filledTemplate);
pdf.SaveAs("product_report.pdf");

using IronPdf;
using System.IO;

// Define a single named tuple with product data
(string productName, decimal price, int count) product = ("Laptop", 799.99m, 5);

// Read the HTML template from a file
string htmlTemplate = File.ReadAllText("template.html");

// Replace placeholders in the template with values from the named tuple
string filledTemplate = htmlTemplate
    .Replace("{0}", product.productName)
    .Replace("{1:C}", product.price.ToString("C"))
    .Replace("{2}", product.count.ToString());

// Convert the filled template to PDF
ChromePdfRenderer Renderer = new ChromePdfRenderer();
PdfDocument pdf = Renderer.RenderHtmlAsPdf(filledTemplate);
pdf.SaveAs("product_report.pdf");

C# 命名元組（開發者如何理解）：圖 8 - HTML 模板

C# 命名元組（開發者如何理解）：圖 9 - 動態填充的 PDF 報告

此範例示範如何使用命名元組動態填入 HTML 範本。 HTML 中的佔位符會被元組中的資料取代，然後將更新後的範本轉換為 PDF。 該方法可以擴展到涉及循環或其他動態資料的更高級場景。

IronPDF在報告產生方面的主要優勢

IronPDF 具有強大的功能，例如HTML 轉 PDF 、圖像和文字浮水印、 PDF 加密和自訂浮水印，使其成為產生動態、資料驅動型 PDF 的理想選擇。 無論您是建立報告、發票還是複雜的摘要，IronPDF 都能透過無縫的資料整合簡化流程。

與 .NET 函式庫和資料結構的無縫集成

IronPDF 可輕鬆與 .NET 的資料結構（包括命名元組）整合。 這樣一來，您就可以直觀地管理資料並產生複雜的 PDF 文件，而無需編寫大量程式碼。 與其他 PDF 庫相比，IronPDF 為開發人員提供了更流暢、更有效率的體驗。 借助元組，您可以產生所需的任意數量的 PDF 文件，利用元組的強大功能確保循環返回多個值。