C# Sıralamalı Liste (Geliştiriciler İçin Nasıl Çalışır)

SortedList Nedir?

C# SortedList sınıfı, bir sözlüğe benzer şekilde anahtar-değer çiftlerinden oluşur, ancak anahtarlara göre otomatik sıralama avantajına sahiptir. System.Collections.Generic ad alanının bir parçasıdır ve sıralı verilere hızlı erişimin gerekli olduğu senaryolar için tasarlanmıştır. SortedList<TKey, TValue>, verileri belirli bir sıra ile tutmanız ve anahtara göre öğelere verimli şekilde erişmeniz gerektiğinde ideal bir seçimdir.

PDF oluşturma görevleriyle birlikte SortedList ile çalışırken, IronPDF bu sınıfla mükemmel bir şekilde entegre olarak PDF oluşturma üzerinde gelişmiş kontrol sağlar.

Anahtar Özellikler ve Kullanım Senaryoları

• Anahtar-Değer Çifti Depolama: Bir sözlük gibi SortedList, verileri anahtar-değer çiftleri olarak depolar.
• Otomatik Sıralama: SortedList, ilişkili değerleri varsayılan olarak anahtara göre artan sırada tutar.
• Etkin Veri Çekilimi: Anahtara göre ilgili değerlerin hızlı çekilimi onu aramalar için uygun hale getirir.
• Kullanım Senaryoları: Sıralı verilere ihtiyaç duyan uygulamalar için uygun; isimler, tarihler veya sayısal değerlerin sıralı listelerini yönetmek gibi.

Veri Yapısı Genel Bakış

Genel sınıf SortedList, bir dizi ve karma tablo karışımı olup öğelerini anahtara göre düzenler. İçsel olarak, anahtar değerlerini sıra içinde tutmak için sıralanmış bir dizi kullanarak anahtara göre etkin erişim garantisi sunar. Ancak, ekleme ve silme işlemleri, bir Dictionary içindekinden daha yavaş olabilir.

Sıralama Mekanizması

Varsayılan olarak, SortedList<TKey, TValue>, anahtarları IComparable arayüzünü kullanarak artan sırayla sıralar; bu da string anahtarlar ve diğer tiplerin varsayılan bir karşılaştırma davranışı uygulamasını sağlar. Özel bir sıralama düzeni ihtiyacı varsa, özelleştirilmiş bir karşılaştırıcı sağlanabilir.

Avantajlar ve Sınırlamalar

• Artıları:
  • Hızlı Anahtar Erişimi: O(log n) anahtarla hızlı erişim sağlar.
  • Sıralı Düzen: Veriler ek sıralama maliyeti olmadan otomatik olarak anahtarlarına göre sıralanır.
• Eksileri:
  • Ekleme Hızı: Dictionary'ye kıyasla eklemelerde daha yavaş; özellikle büyük veri boyutlarında.
  • Anahtar Dışı İşlemler İçin Sınırlı Verimlilik: Verinin esas olarak belirli anahtar değerleriyle erişilmediği senaryolar için daha az verimlidir.

Bir SortedList Oluşturma

C#'da bir SortedList oluşturabilirsiniz; ya varsayılan yapılandırıcıyı kullanarak ya da özelleştirilmiş sıralama gerekiyorsa bir IComparer geçirerek. SortedList varsayılan kapasitesi 16 olur. Tahmini boyut bilindiğinde performans iyileştirmeleri için ayarlanabilir.

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

Öğe Ekleme

SortedList'ye anahtar-değer çiftleri eklemek için Add metodunu kullanın. Bu, öğeyi anahtarlarına göre sıralı halde tutar. Aşağıdaki kod, SortedList verilerini anahtarların artan sırasına göre düzenler.

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

Öğeye Erişim ve Değiştirme

SortedList içindeki öğelere anahtarlarıyla erişin. İlgili değerleri doğrudan geri almak veya değiştirmek için anahtarlar kullanılabilir.

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

Öğe Kaldırma

Remove metodu ile belirli anahtarları kullanarak veya RemoveAt ile belirtilen indeksi kullanarak öğeleri kaldırın. Her ikisi de SortedList nesnelerini kontrollü bir şekilde silmenize olanak tanır.

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

Bir SortedList Üzerinde Dolaşma

Anahtarlar ve değerleri sıralı şekilde almak için bir foreach döngüsü kullanarak SortedList üzerinde yineleyin.

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'i Sözlük ve Liste ile Karşılaştırma

• SortedList vs. Sözlük: SortedList, Sözlük'ten daha yavaş çalışır, çünkü sıralama maliyeti vardır.
• SortedList vs. Liste: Liste'nin aksine, SortedList, elemanların anahtarla erişimi ve sıralı düzen için tasarlanmıştır.

SortedList Ne Zaman Kullanmalı: Sıralı veri gerektiğinde ve esas olarak anahtarla erişildiğinde, özellikle anahtar tabanlı senaryolar için kullanılmalı.

IronPDF'ye Giriş

IronPDF C#'ta PDF dosyaları oluşturma ve düzenleme için güçlü bir kütüphanedir. Bu, geliştiricilere çeşitli kaynaklardan PDF'ler oluşturma, içerik programlama yoluyla ekleme ve PDF düzenlerini özelleştirme şansı tanır. Bu bölümde IronPDF kullanarak SortedList verisinden bir PDF raporu oluşturacağız.

SortedList Verisinden PDF Raporları Oluşturma

IronPDF kullanmaya başlamak için IronPDF NuGet paketini kurun:

Install-Package IronPdf

Örnek: SortedList'ten Veri İhracı ve PDF'e Dönüştürme

Aşağıdaki örnek SortedList'ten veriyi bir PDF tablosuna aktarma işlemini gösterir.

Öncelikle, SortedList kurulumunu yapın:

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

Sonra, IronPDF kullanarak PDF'yi bu verilerden üretin:

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

Bu kod, SortedList verilerinden bir HTML tablosu oluşturur ve IronPDF kullanarak bunu bir PDF'e çevirir.

Gelişmiş Özellikler

• PDF Düzenini Özelleştirme: IronPDF, tasarım, yazılar, renkler ve daha fazlası için CSS stili sağlar.
• Başlıklar ve Alt Bölümler: IronPDF, sayfa numaraları veya logolar içerebilecek başlıklar ve alt bölümler sunar.