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

' 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 循环遍历 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：由于排序开销，与 Dictionary 相比，SortedList 的插入速度较慢。
• 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" }
};

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