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を渡してSortedListをC#で作成できます。 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の反復

SortedListを反復するには、foreachループを使用してキーと値の両方をソートされた順序で取得します。

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: 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はページ番号やロゴを含むヘッダーとフッターをサポートします。