C# Sorted List (Comment ça fonctionne pour les développeurs)

Qu'est-ce qu'un SortedList ?

La classe C# SortedList est une collection de paires clé-valeur, similaire à un dictionnaire, mais elle a l'avantage supplémentaire d'un tri automatique par clés. Il fait partie de l'espace de noms System.Collections.Generic et est conçu pour les scénarios où vous avez besoin d'un accès rapide aux données triées. SortedList<TKey, TValue> est idéal lorsque vous devez maintenir les données dans un ordre particulier et accéder efficacement aux éléments par clé.

Lors du travail avec SortedLists en parallèle des tâches de génération de PDF, IronPDF s'intègre parfaitement avec cette classe, offrant un contrôle amélioré sur la génération de PDF.

Fonctionnalités principales et cas d'utilisation

• Stockage par paires clé-valeur : comme un dictionnaire, SortedList stocke les données sous forme de paires clé-valeur.
• Tri automatique : SortedList conserve par défaut les valeurs associées triées par clé dans l'ordre croissant.
• Récupération efficace des données : la récupération rapide des valeurs associées par clé la rend adaptée aux recherches.
• Cas d'utilisation : Utile pour les applications nécessitant des données triées, telles que la gestion de listes ordonnées de noms, de dates ou de valeurs numériques.

Vue d'ensemble des structures de données

La classe publique SortedList est un hybride entre un tableau et une table de hachage et organise ses éléments par clé. En interne, elle utilise un tableau trié pour garder les valeurs clés en ordre, garantissant des recherches efficaces par clé. Cependant, les opérations d'insertion et de suppression peuvent être plus lentes que dans un Dictionary.

Mécanisme de tri

Par défaut, SortedList<TKey, TValue> trie les clés dans l'ordre croissant en utilisant l'interface IComparable, ce qui garantit que les clés de type chaîne et d'autres types implémentent un comportement de comparaison par défaut. Si un ordre de tri personnalisé est nécessaire, un comparateur personnalisé peut être fourni.

Avantages et limitations

• Avantages :
  • Accès rapide par clé : Fournit un accès rapide O(log n) par clé.
  • Ordre de tri : les données sont automatiquement triées par clé sans surcharge de tri supplémentaire.
• Inconvénients :
  • Vitesse d'insertion : Plus lente que Dictionary pour les insertions, en particulier avec des tailles de données importantes.
  • Efficacité limitée pour les opérations non liées aux clés : moins efficace dans les scénarios où les données ne sont pas principalement consultées par des valeurs clés spécifiques.

Créer un SortedList

Vous pouvez créer un SortedList en C# en utilisant soit le constructeur par défaut, soit en passant un IComparer si un tri personnalisé est nécessaire. Le SortedList a une capacité initiale par défaut de 16, qui peut être ajustée pour améliorer les performances lorsque la taille approximative est connue.

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

Ajout d'éléments

Ajoutez des paires clé-valeur à SortedList en utilisant la méthode Add. Cela permet de garder les éléments triés par clé. Le code suivant garde les données du SortedList dans l'ordre croissant des clés.

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")

Accès et modification des éléments

Accédez aux éléments d'un SortedList par leurs clés. Vous pouvez récupérer ou modifier les valeurs associées aux clés directement.

// 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"

Suppression d'éléments

Supprimez les éléments en utilisant des clés spécifiques avec la méthode Remove ou en utilisant l'index spécifié avec RemoveAt. Les deux permettent la suppression contrôlée d'objets du 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

Itérer sur un SortedList

Parcourir SortedList en utilisant une boucle foreach pour récupérer à la fois les clés et les valeurs dans l'ordre trié.

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

Comparaison de SortedList avec Dictionary et List

• SortedList vs. Dictionary : SortedList est plus lent pour les insertions que Dictionary en raison de la surcharge liée au tri.
• SortedList vs. List : Contrairement à une liste, SortedList est conçue pour accéder aux éléments par clé et maintenir l'ordre de tri.

Quand utiliser SortedList : Utilisez-le lorsque vous avez besoin de données triées et que vous y accédez principalement par clé, notamment dans les scénarios où la lecture est intensive.

Introduction à IronPDF

IronPDF est une bibliothèque puissante pour générer et modifier des fichiers PDF en C#. Il permet aux développeurs de créer des PDF à partir de diverses sources, d'ajouter du contenu par programmation et de personnaliser la mise en page des PDF. Dans cette section, nous utiliserons IronPDF pour créer un rapport PDF à partir des données du SortedList.

Génération de rapports PDF à partir des données du SortedList

Pour commencer à utiliser IronPDF, installez le package NuGet IronPDF :

Install-Package IronPdf

Exemple : Exporter des données d'un SortedList vers un PDF

L'exemple suivant démontre comment exporter des données d'un SortedList vers un tableau PDF.

Tout d'abord, configurez votre 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"}
}

Ensuite, utilisez IronPDF pour générer un PDF à partir de ces données :

// 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")

Ce code crée un tableau HTML à partir des données du SortedList et le convertit en PDF à l'aide d'IronPDF.

Les fonctionnalités avancées

• Personnalisation de la mise en page PDF : IronPDF permet d'appliquer des styles CSS à la mise en page, aux polices, aux couleurs, etc.
• En-têtes et pieds de page : IronPDF prend en charge les en-têtes et les pieds de page, qui peuvent inclure des numéros de page ou des logos.