A classe C# SortedList é uma coleção de pares chave-valor, semelhante a um dicionário, mas tem o benefício adicional de ordenação automática por chaves. Faz parte do namespace System.Collections.Generic e é projetada para cenários onde você precisa de acesso rápido a dados ordenados. SortedList<TKey, TValue> é ideal quando você precisa manter dados em uma ordem específica e acessar elementos eficientemente por chave.
Ao trabalhar com SortedLists em conjunto com tarefas de geração de PDF, o IronPDF se integra perfeitamente a essa classe, proporcionando maior controle sobre a geração de PDFs.
SortedList mantém valores associados ordenados por chave em ordem crescente por padrão.A classe pública SortedList é um híbrido entre um array e uma tabela hash e organiza seus itens por chave. Internamente, utiliza um array ordenado para manter os valores das chaves em ordem, garantindo buscas eficientes por chave. No entanto, as operações de inserção e exclusão podem ser mais lentas do que em um Dictionary.
Por padrão, SortedList<TKey, TValue> ordena chaves em ordem crescente usando a interface IComparable, que garante que chaves de string e outros tipos implementem um comportamento de comparação padrão. Caso seja necessária uma ordem de classificação personalizada, um comparador personalizado pode ser fornecido.
Dictionary para inserções, especialmente com grandes volumes de dados.Você pode criar um SortedList em C# usando o construtor padrão ou passando um IComparer se for necessário uma ordenação personalizada. O SortedList tem uma capacidade inicial padrão de 16, que pode ser ajustada para melhorias de desempenho quando o tamanho aproximado é conhecido.
// 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)()Adicione pares chave-valor ao SortedList usando o método Add. Isso mantém os itens classificados por chave. O código a seguir mantém os dados da SortedList em ordem crescente de chaves.
sortedList.Add(1, "Apple");
sortedList.Add(3, "Banana");
sortedList.Add(2, "Cherry");sortedList.Add(1, "Apple")
sortedList.Add(3, "Banana")
sortedList.Add(2, "Cherry")Acesse elementos em um SortedList por suas chaves. Você pode recuperar ou modificar diretamente os valores associados às chaves.
// 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"Remova itens usando chaves específicas com o método Remove ou usando o índice especificado com RemoveAt. Ambos permitem a exclusão controlada de objetos do SortedList.
sortedList.Remove(3); // Removes the entry with key 3
sortedList.RemoveAt(0); // Removes the entry at the zero-based index 0sortedList.Remove(3) ' Removes the entry with key 3
sortedList.RemoveAt(0) ' Removes the entry at the zero-based index 0Itere sobre SortedList usando um loop foreach para recuperar tanto chaves quanto valores em ordem.
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 em cenários mais complexos, como exibir logs de transações ordenados ou pontuações classificadas.Melhores práticas:
SortedList quando as chaves forem o ponto de acesso principal e precisarem permanecer ordenadas.SortedDictionary para melhor desempenho.Quando usar SortedList: Use-o quando precisar de dados ordenados e acessá-los principalmente por chave, especialmente em cenários com grande volume de leituras.
IronPDF é uma biblioteca poderosa para gerar e modificar arquivos PDF em C#. Permite aos desenvolvedores criar PDFs a partir de diversas fontes, adicionar conteúdo programaticamente e personalizar layouts de PDF. Nesta seção, usaremos o IronPDF para criar um relatório em PDF a partir de dados de uma lista ordenada.
Para começar a usar o IronPDF , instale o pacote NuGet do IronPDF :
O exemplo a seguir demonstra como exportar dados de uma SortedList para uma tabela em PDF.
Primeiro, configure seu SortedList:
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"}
}Em seguida, use o IronPDF para gerar um PDF a partir desses dados:
// 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")
Este código cria uma tabela HTML a partir dos dados da SortedList e a converte em um PDF usando o IronPDF.
Neste artigo, exploramos a classe C# SortedList, uma ferramenta poderosa para gerenciar coleções de dados chave-valor ordenadas. SortedList é especialmente útil em cenários onde a ordem e o acesso eficiente por chave são críticos. Desde a criação, adição e remoção de elementos até a integração com IronPDF para exportação de PDF, cobrimos etapas práticas e melhores práticas para usar SortedList em aplicações do mundo real.
Além disso, mostramos como IronPDF pode simplificar a tarefa de exportar valores especificados de um SortedList para o formato PDF, permitindo a fácil criação de relatórios profissionais e bem organizados. A versatilidade do IronPDF, incluindo cabeçalhos, rodapés e estilos CSS personalizáveis, o torna uma excelente opção para gerar PDFs diretamente de seus aplicativos C#.
Se você estiver interessado em experimentar o IronPDF, ele oferece um período de teste gratuito que permite explorar todos os seus recursos sem compromisso. Esta versão de avaliação permite testar a geração de PDFs, as opções de personalização e a integração em projetos existentes para garantir que atenda às suas necessidades. Ao combinar SortedList e IronPDF, os desenvolvedores ganham uma solução robusta e eficiente para gerenciar e relatar dados ordenados em aplicações C#.
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
