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 çiftlerinin bir koleksiyonudur, ancak anahtarlara göre otomatik sıralama avantajı ek bir benefitdir. Bu, System.Collections.Generic ad alanının bir parçasıdır ve sıralı verilere hızlı erişim gerektiğinde senaryolar için tasarlanmıştır. SortedList<TKey, TValue>, verileri belirli bir sırayla tutmanız gerektiğinde ve anahtara göre elemanlara verimli bir şekilde erişmeniz gerektiğinde idealdir.

SortedList ile PDF oluşturma görevleri üzerinde çalışırken, IronPDF, bu sınıfla mükemmel bir şekilde entegre olur ve PDF oluşturma üzerinde geliştirilmiş kontrol sağlar.

Temel Özellikler ve Kullanım Durumları

• Anahtar-Değer Çiftleri Depolama: Bir sözlük gibi, SortedList de verileri anahtar-değer çiftleri olarak saklar.
• Otomatik Sıralama: SortedList, ilişkilendirilmiş değerleri varsayılan olarak artan sırayla anahtarlara göre sıralar.
• Verimli Veri Alma: Anahtar aracılığıyla ilişkili değerlerin hızlı bir şekilde alınması, onu aramalar için uygun hale getirir.
• Kullanım Durumları: İsim, tarih veya sayısal değerlerin sıralı listelerini yönetmek gibi sıralı verilere ihtiyaç duyan uygulamalar için kullanışlıdır.

Veri Yapısı Genel Bakış

Genel sınıf SortedList, bir dizi ve bir karma tablo arasında bir hibrittir ve öğelerini anahtara göre düzenler. İçsel olarak anahtar değerlerini düzenli tutmak için sıralanmış bir dizi kullanır, böylece anahtar tarafından verimli aramalar sağlanır. Ancak, ekleme ve silme işlemleri Dictionary'daki işlemlerden daha yavaş olabilir.

Sıralama Mekanizması

Varsayılan olarak, SortedList<TKey, TValue>, IComparable arabirimini kullanarak anahtarları artan sırayla sıralar, bu da dizi anahtarlarının ve diğer türlerin varsayılan karşılaştırma davranışını uygulamasını sağlar. Özelleştirilmiş bir sıralama düzenine ihtiyaç duyulursa, özelleştirilmiş bir karşılaştırıcı sağlanabilir.

Avantajlar ve Sınırlamalar

• Artıları:
  • Hızlı Anahtar Erişimi: Anahtar tarafından O(log n) hızında hızlı erişim sağlar.
  • Sıralı Düzen: Veri, anahtara göre otomatik olarak sıralanır ve ek sıralama yükü olmadan.
• Eksileri:
• Ekleme Hızı: Özellikle büyük veri boyutlarında, Dictionary'ye göre eklemelerde daha yavaştır.
  • Anahtar Olmayan İşlemler için Sınırlı Verimlilik: Veriye esas olarak belirli anahtar değerleri aracılığıyla erişilmeyen senaryolarda daha az verimli.

Bir SortedList Oluşturma

C#'da ya varsayılan kurucu kullanarak ya da özel sıralama gerekiyorsa bir IComparer geçirerek bir SortedList oluşturabilirsiniz. SortedList, bilinen yaklaşık boyutlarla performans iyileştirmeleri için ayarlanabilen varsayılan bir başlangıç kapasitesine sahiptir.

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

Ögeler Ekleme

SortedList'e anahtar-değer çiftleri eklemek için Add yöntemini kullanın. Bu, öğelerin anahtarlarına göre sıralı kalmasını sağlar. Aşağıdaki kod, SortedList verilerini anahtarların artan sırasına göre tutar.

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

Öğelere Erişme ve Değiştirme

SortedList içerisindeki elemanlara anahtarlarıyla erişin. Anahtarlarla ilişkilendirilen değerleri doğrudan alabilir ya da değiştirebilirsiniz.

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

Öğeleri Silme

Belirli anahtarlar kullanarak Remove yöntemiyle veya belirtilen indisi RemoveAt kullanarak öğeleri çıkarın. Her ikisi de SortedList tarihinden objelerin kontrollü silinmesine izin verir.

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 Yineleme Yapma

Anahtarları ve değerleri sıralı olarak elde etmek için bir foreach döngüsü kullanarak SortedList üzerinden 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 Listeyle Karşılaştırma

• SortedList ve Sözlük: SortedList, ekleme işlemlerinde sözlüğe göre daha yavaştır çünkü sıralama yükü vardır.
• SortedList ve Liste: Bir listeden farklı olarak, SortedList, elemanlara anahtar aracılığıyla erişmek ve sıralı düzeni korumak için tasarlanmıştır.

SortedList Ne Zaman Kullanılır: Sıralı verilere ihtiyacınız olduğunda ve esas olarak anahtarlar aracılığıyla erişiyorsanız ve özellikle yoğun okuma senaryolarında kullanın.

IronPDF'e Giriş

IronPDF, C# dilinde PDF dosyaları oluşturmak ve değiştirmek için güçlü bir kütüphanedir. Çeşitli kaynaklardan PDF'ler oluşturmanıza, içerik ekleyip düzenlemenize ve PDF düzenlerini özelleştirmenize olanak tanır. Bu bölümde, IronPDF'i kullanarak SortedList verilerinden bir PDF raporu oluşturacağız.

SortedList Verilerinden PDF Raporları Oluşturma

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

Install-Package IronPdf

Örnek: SortedList'den Verilerin PDF'e Dışa Aktarılması

Aşağıdaki örnek, SortedList'den bir PDF tablosuna veri dışa aktarmayı gösterir.

Önce, sizin SortedList ayarlayı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, bu verilerden bir PDF oluşturmak için IronPDF'i kullanın:

// 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 tablo oluşturur ve bu tabloyu IronPDF kullanarak bir PDF'e dönüştürür.

Gelişmiş Özellikler

• PDF Düzenini Özelleştirme: IronPDF, düzenler, yazı tipleri, renkler vb. için CSS stillendirmesine olanak tanır.
• Başlıklar ve Altbilgiler: IronPDF, sayfa numaraları veya logolar içerebilecek başlıkları ve altbilgileri destekler.