C# SortedList（開發者完整指南）

什麼是 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 插入時較慢，特別是在大資料量的情況下。
  • 非鍵操作的有限效率：在資料不是主要根據具體鍵值存取的情境中效率較低。

建立 SortedList

您可以在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>();

' Create a SortedList with integer keys and string values
Dim sortedList As New SortedList(Of Integer, String)()

新增項目

using 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.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"

' Accessing a specific value by key
Dim value As String = sortedList(1) ' Retrieves "Apple"
' Modifying a value
sortedList(1) = "Avocado" ' Changes the value associated with key 1 to "Avocado"

刪除項目

using 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

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

迭代 SortedList

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

For Each kvp As KeyValuePair(Of Integer, String) In sortedList
	Console.WriteLine($"Key: {kvp.Key}, Value: {kvp.Value}")
Next kvp

C# Sorted List (開發者如何工作)：圖1

將 SortedList 與 Dictionary 和 List 比較

• SortedList vs. Dictionary：由於排序開銷，SortedList 插入速度比 Dictionary 慢。
• SortedList vs. List：與列表不同，SortedList 設計用於按鍵存取元素並維持排序順序。

何時使用 SortedList：當您需要已排序資料並主要按鍵存取時，特別是對於讀取密集情形。

IronPDF介紹

C# Sorted List (開發者如何工作)：圖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" }
};

Dim sortedList As New SortedList(Of Integer, String) From {
	{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");

' Initialize a PDF renderer
Dim renderer As New ChromePdfRenderer()

' Build HTML string with table format
Dim html As String = "<h1>Sorted List Data</h1><table border='1'><tr><th>Key</th><th>Value</th></tr>"
For Each kvp In sortedList
	html &= $"<tr><td>{kvp.Key}</td><td>{kvp.Value}</td></tr>"
Next kvp
html &= "</table>"

' Render HTML to PDF and save it
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("sortedList.pdf")

C# Sorted List (開發者如何工作)：圖3

此程式碼從 SortedList 資料建立 HTML 表格，並使用 IronPDF 將其轉換為 PDF。

進階功能

• 自定義 PDF 版面：IronPDF 允許用 CSS 樣式設定版面、字體、顏色等。
• 頁眉和頁腳：IronPDF 支援頁眉和頁腳，其中可以包含頁碼或商標。