C# Sorted List（開発者向けの仕組み）

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: SortedList は、ソートのオーバーヘッドにより、Dictionary に比べて挿入速度が遅くなります。
• SortedList と List:リストとは異なり、SortedList はキーで要素にアクセスし、ソートされた順序を維持するように設計されています。

SortedList を使用する場合:並べ替えられたデータが必要で、主にキーでアクセスする場合、特に読み取りが多いシナリオで使用します。

IronPDFの紹介

IronPDFは、C#でPDFファイルを生成し、修正するための強力なライブラリです。 これは開発者がさまざまなソースからPDFを作成し、プログラム的にコンテンツを追加し、PDFレイアウトをカスタマイズすることを可能にします。 このセクションでは、SortedListデータからPDFレポートを作成するためにIronPDFを使用します。

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 は、ページ番号やロゴを含めることができるヘッダーとフッターをサポートしています。