C# 排序列表（开发者如何使用）

什么是 SortedList？

C# SortedList 类是一个键值对集合，类似于字典，但它具有按键自动排序的额外优点。 它是 System.Collections.Generic 命名空间的一部分，专为需要快速访问排序数据的场景设计。 SortedList<TKey, TValue> 非常适合需要保持数据以特定顺序排列并按键高效访问元素的情况。

当在 PDF 生成任务中与 SortedLists 一起使用时，IronPDF 完美地与此类集成，增强了对 PDF 生成的控制。

主要特点和用例

• 键值对存储： 像字典一样，SortedList以键值对的形式存储数据。
• 自动排序： SortedList 默认情况下按升序键保持相关值排好序。
• 高效数据检索： 能够通过键快速检索相关值，使其适用于查找。
• 使用场景： 适合需要排序数据的应用场景，例如管理按顺序排列的名称、日期或数值列表。

数据结构概述

public 类 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>();

添加项目

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

迭代 SortedList

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

将 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 支持页眉和页脚，可以包括页码或标志。