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插入速度較慢，特別是對於大型資料。
  • 針對非鍵操作的有限效率：在資料主要不是通過特定鍵值訪問的情況下，效率較低。

創建SortedList

您可以在C#中使用默認構造函數創建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>();

添加項目

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

移除項目

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

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

比較SortedList與Dictionary和List

• SortedList與Dictionary：由於排序負擔，SortedList插入速度較慢於Dictionary。
• SortedList與List：與清單不同，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" }
};

接下來，使用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");

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

進階功能

• 自定義PDF佈局： IronPDF允許用CSS樣式化佈局、字體、顏色等。
• 頁眉和頁腳： IronPDF支援頁眉和頁腳，可以包含頁碼或徽標。