C# 排序列表 (如何為開發人員運作)

主要功能和使用案例

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

資料結構概述

公用類別 SortedList 是陣列和雜湊表的混合體，它按鍵組織其項目。 在內部，它使用排序陣列來保持關鍵值的順序，以確保依關鍵進行有效的查詢。 但是，插入和刪除操作可能比在 Dictionary 中慢。

排序機制

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

優點和限制

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

建立排序清單

您可以使用預設建構函數或在需要自訂排序時傳遞 IComparer 在 C# 中建立 SortedList。 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)()

新增項目

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

移除項目

使用 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，依排序順序擷取鍵和值。

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

SortedList 與 Dictionary 和 List 的比較

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

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

IronPDF 簡介

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")

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

進階功能

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