C# 排序清單（開發者如何實現）

什麼是 SortedList？

C# SortedList類別是一個鍵值對的集合，類似字典，但它還有一個額外的優點，就是按鍵自動排序。 它是System.Collections.Generic命名空間的一部分，專為需要快速存取排序資料的場景而設計。 SortedList<TKey, TValue>當您需要按特定順序維護資料並按鍵高效存取元素時，它是理想之選。

當使用SortedLists執行 PDF 生成任務時，IronPDF 與此類完美集成，從而增強了對 PDF 生成的控制。

主要特性與應用案例

*鍵值對儲存：*與字典類似，SortedList 將資料儲存為鍵值對。 自動排序： SortedList預設按鍵升序排列關聯值。 高效率的資料擷取：按鍵快速擷取關聯值，使其適用於尋找。 使用案例：**適用於需要排序資料的應用程序，例如管理有序的名稱、日期或數值清單。

資料結構概述

公共類別SortedList是數組和哈希表的混合體，它按鍵組織其項。 內部使用排序數組來保持鍵值的順序，從而確保按鍵有效率地尋找。 但是，插入和刪除操作可能比Dictionary中的操作慢。

排序機制

預設情況下， SortedList<TKey, TValue>使用IComparable介面按升序對鍵進行排序，確保字串鍵和其他類型實現預設的比較行為。 如果需要自訂排序順序，可以提供自訂比較器。

優點與局限性

優點： *快速金鑰存取：*提供快速的 O(log n) 金鑰存取。 按鍵自動排序：資料按鍵自動排序，無需額外的排序開銷。 缺點： 插入速度：比Dictionary插入慢，尤其是在資料量很大的情況下。 非鍵操作效率有限：**在資料並非主要透過特定鍵值存取的情況下，效率較低。

建立排序列表

在 C# 中，您可以使用預設建構子建立SortedList ，如果需要自訂排序，也可以傳遞IComparer 。 SortedList預設初始容量為 16，當知道大致大小時，可以調整此值以提高效能。

// Create a SortedList with integer keys and string values
SortedList<int, string> sortedList = new SortedList<int, string>();

// Create a SortedList with integer keys and string values
SortedList<int, string> sortedList = new SortedList<int, string>();

添加商品

使用Add方法為SortedList新增鍵值對。 這樣可以按鍵來對項目進行排序。 以下程式碼將 SortedList 中的資料按鍵升序排列。

sortedList.Add(1, "Apple");
sortedList.Add(3, "Banana");
sortedList.Add(2, "Cherry");

sortedList.Add(1, "Apple");
sortedList.Add(3, "Banana");
sortedList.Add(2, "Cherry");

訪問和修改元素

透過鍵存取SortedList中的元素。 您可以直接檢索或修改與鍵關聯的值。

// Accessing a specific value by key
string value = sortedList[1];  // Retrieves "Apple"
// Modifying a value
sortedList[1] = "Avocado";   // Changes the value associated with key 1 to "Avocado"

// Accessing a specific value by key
string value = sortedList[1];  // Retrieves "Apple"
// Modifying a value
sortedList[1] = "Avocado";   // Changes the value associated with key 1 to "Avocado"

移除物品

使用Remove方法透過特定鍵刪除項目，或使用RemoveAt方法透過指定索引刪除項目。 兩者都允許從SortedList中受控刪除物件。

sortedList.Remove(3);       // Removes the entry with key 3
sortedList.RemoveAt(0);     // Removes the entry at the zero-based index 0

sortedList.Remove(3);       // Removes the entry with key 3
sortedList.RemoveAt(0);     // Removes the entry at the zero-based index 0

遍歷已排序列表

使用foreach循環遍歷SortedList ，依排序順序擷取鍵和值。

foreach (KeyValuePair<int, string> kvp in sortedList)
{
    Console.WriteLine($"Key: {kvp.Key}, Value: {kvp.Value}");
}

foreach (KeyValuePair<int, string> kvp in sortedList)
{
    Console.WriteLine($"Key: {kvp.Key}, Value: {kvp.Value}");
}

C# 排序清單（開發者如何理解其工作原理）：圖 1

比較 SortedList、Dictionary 和 List

• SortedList 與 Dictionary：由於排序開銷，SortedList 的插入速度比 Dictionary 慢。
• SortedList 與 List 的差異：與清單不同，SortedList 旨在透過鍵存取元素並保持排序順序。

何時使用 SortedList：當您需要排序資料並且主要透過鍵存取資料時，尤其是在讀取密集型場景中，可以使用 SortedList。

IronPDF簡介

C# 排序清單（開發者如何理解其工作原理）：圖 2

IronPDF是一個功能強大的 C# 庫，用於產生和修改 PDF 文件。 它允許開發人員從各種來源建立 PDF，以程式設計方式添加內容，並自訂 PDF 佈局。 在本節中，我們將使用 IronPDF 從 SortedList 資料建立 PDF 報告。

從 SortedList 資料產生 PDF 報告

若要開始使用 IronPDF，請安裝 IronPDF NuGet 套件：

Install-Package IronPdf

範例：將 SortedList 中的資料匯出到 PDF

以下範例示範如何將 SortedList 中的資料匯出到 PDF 表格。

首先，設定你的SortedList ：

SortedList<int, string> sortedList = new SortedList<int, string>
{
    { 1, "Apple" },
    { 2, "Banana" },
    { 3, "Cherry" }
};

SortedList<int, string> sortedList = new SortedList<int, string>
{
    { 1, "Apple" },
    { 2, "Banana" },
    { 3, "Cherry" }
};

接下來，使用 IronPDF 從這些數據產生 PDF 文件：

// Initialize a PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Build HTML string with table format
string html = "<h1>Sorted List Data</h1><table border='1'><tr><th>Key</th><th>Value</th></tr>";
foreach (var kvp in sortedList)
{
    html += $"<tr><td>{kvp.Key}</td><td>{kvp.Value}</td></tr>";
}
html += "</table>";

// Render HTML to PDF and save it
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("sortedList.pdf");

// Initialize a PDF renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Build HTML string with table format
string html = "<h1>Sorted List Data</h1><table border='1'><tr><th>Key</th><th>Value</th></tr>";
foreach (var kvp in sortedList)
{
    html += $"<tr><td>{kvp.Key}</td><td>{kvp.Value}</td></tr>";
}
html += "</table>";

// Render HTML to PDF and save it
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("sortedList.pdf");

C# 排序清單（開發者如何理解其工作原理）：圖 3

這段程式碼根據 SortedList 資料建立 HTML 表格，並使用 IronPDF 將其轉換為 PDF。

進階功能

*自訂 PDF 佈局：* IronPDF 允許使用 CSS 樣式來設定佈局、字體、顏色等。 頁首和頁尾：** IronPDF 支援頁首和頁尾，其中可以包含頁碼或標誌。