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

アイテムの追加

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内の要素にアクセスします。 キーに直接関連する値を取得したり修正したりできます。

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

アイテムの削除

特定のキーを使用して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の反復

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

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

次に、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");

このコードはSortedListデータからHTMLテーブルを作成し、IronPDFを使用してPDFに変換します。

高度な機能

• PDF レイアウトのカスタマイズ: IronPDF では、レイアウト、フォント、色などの CSS スタイルを設定できます。 *ヘッダーとフッター: IronPDF は、ページ番号やロゴを含めることができるヘッダーとフッターをサポートしています。