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

什么是 SortedList？

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

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

主要特点和用例

*键值对存储：*与字典类似，SortedList 将数据存储为键值对。 自动排序： SortedList默认按键升序排列关联值。 高效的数据检索：按键快速检索关联值，使其适用于查找。 使用案例：**适用于需要排序数据的应用程序，例如管理有序的名称、日期或数值列表。

数据结构概述

公共类 SortedList 是数组和哈希表的混合体，通过键组织其项目。 在内部，它使用排序数组来保持键值的顺序，确保通过键进行高效查找。 然而，插入和删除操作可能比 Dictionary 慢。

排序机制

默认情况下，SortedList<TKey, TValue> 使用 IComparable 接口将键按升序排序，这确保字符串键和其他类型实现默认比较行为。 如果需要自定义排序顺序，可以提供自定义比较器。

优势和限制

优点： *快速密钥访问：*提供快速的 O(log n) 密钥访问。 按键自动排序：数据按键自动排序，无需额外的排序开销。 缺点： 插入速度：比Dictionary插入慢，尤其是在数据量很大的情况下。 非键操作效率有限：**在数据并非主要通过特定键值访问的情况下，效率较低。

创建 SortedList

您可以使用默认的构造函数或在需要自定义排序时传递 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>();

添加项目

使用 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：当您需要排序数据并且主要通过键访问数据时，尤其是在读取密集型场景中，可以使用 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 支持页眉和页脚，其中可以包含页码或徽标。