C# Collection（開発者向けの動作方法）

非ジェネリックコレクションタイプ

ArrayList、Hashtable、Queueは、C#の初期のバージョンに含まれる非ジェネリックコレクションクラスです。 これらのコレクションは、保存および操作したいもののタイプを明示的に定義する代替手段を提供します。 ただし、開発者は通常、その優れたパフォーマンスと型の安全性のためにジェネリックコレクションを選択します。

ジェネリックコレクション

C#の後続のバージョンでは、非ジェネリックコレクションの欠点を克服するためにジェネリックコレクションが含まれています。 これにより、コンパイル時の型の安全性が提供され、開発者が厳密に型指定されたデータを扱うことができます。 一般的に使用されるジェネリックコレクションクラスには、List、Dictionary<TKey, TValue>、Queue、Stackなどがあります。 これらのコレクションは、優れたパフォーマンスとコンパイル時の型検証を提供するため、現代のC#開発において最適な選択肢となっています。

主要なC#コレクションタイプ

// Creating a list with integers and adding/removing elements
List<int> numbers = new List<int> { 1, 2, 3, 4, 5 };
numbers.Add(6); // Adds element '6' to the end
numbers.Remove(3); // Removes the first occurrence of the element '3'

// Creating a list with integers and adding/removing elements
List<int> numbers = new List<int> { 1, 2, 3, 4, 5 };
numbers.Add(6); // Adds element '6' to the end
numbers.Remove(3); // Removes the first occurrence of the element '3'

' Creating a list with integers and adding/removing elements
Dim numbers As New List(Of Integer) From {1, 2, 3, 4, 5}
numbers.Add(6) ' Adds element '6' to the end
numbers.Remove(3) ' Removes the first occurrence of the element '3'

// Creating a dictionary mapping names to ages
Dictionary<string, int> ageMap = new Dictionary<string, int>();
ageMap.Add("John", 25); // The string "John" is the key that can access the value 25
ageMap["Jane"] = 30; // Setting the key "Jane" to hold the value 30

// Creating a dictionary mapping names to ages
Dictionary<string, int> ageMap = new Dictionary<string, int>();
ageMap.Add("John", 25); // The string "John" is the key that can access the value 25
ageMap["Jane"] = 30; // Setting the key "Jane" to hold the value 30

' Creating a dictionary mapping names to ages
Dim ageMap As New Dictionary(Of String, Integer)()
ageMap.Add("John", 25) ' The string "John" is the key that can access the value 25
ageMap("Jane") = 30 ' Setting the key "Jane" to hold the value 30

// Creating and manipulating a queue
Queue<string> tasks = new Queue<string>(); 
tasks.Enqueue("Task 1"); // Adding to the queue
tasks.Enqueue("Task 2");

// Creating and manipulating a stack
Stack<double> numbers = new Stack<double>();
numbers.Push(3.14); // Adding to the stack
numbers.Push(2.71);

// Creating and manipulating a queue
Queue<string> tasks = new Queue<string>(); 
tasks.Enqueue("Task 1"); // Adding to the queue
tasks.Enqueue("Task 2");

// Creating and manipulating a stack
Stack<double> numbers = new Stack<double>();
numbers.Push(3.14); // Adding to the stack
numbers.Push(2.71);

' Creating and manipulating a queue
Dim tasks As New Queue(Of String)()
tasks.Enqueue("Task 1") ' Adding to the queue
tasks.Enqueue("Task 2")

' Creating and manipulating a stack
Dim numbers As New Stack(Of Double)()
numbers.Push(3.14) ' Adding to the stack
numbers.Push(2.71)

// Creating hashsets and performing a union operation
HashSet<int> setA = new HashSet<int> { 1, 2, 3, 4 };
HashSet<int> setB = new HashSet<int> { 3, 4, 5, 6 };
HashSet<int> unionSet = new HashSet<int>(setA);
unionSet.UnionWith(setB); // Combining setA and setB

// Creating hashsets and performing a union operation
HashSet<int> setA = new HashSet<int> { 1, 2, 3, 4 };
HashSet<int> setB = new HashSet<int> { 3, 4, 5, 6 };
HashSet<int> unionSet = new HashSet<int>(setA);
unionSet.UnionWith(setB); // Combining setA and setB

' Creating hashsets and performing a union operation
Dim setA As New HashSet(Of Integer) From {1, 2, 3, 4}
Dim setB As New HashSet(Of Integer) From {3, 4, 5, 6}
Dim unionSet As New HashSet(Of Integer)(setA)
unionSet.UnionWith(setB) ' Combining setA and setB

<!a href="/static-assets/pdf/blog/csharp-collection/csharp-collection-1.webp">C# Collection (How It Works For Developers): Figure 1 - IronPDF website page

C#のライブラリであるIronPDFは、.NETアプリケーションでPDFドキュメントを作成、編集、表示するのを簡単にします。 多くのライセンスオプション、クロスプラットフォームの互換性、高品質なレンダリング、HTMLからPDFへの変換を提供します。 IronPDFの使いやすいAPIはPDFの取り扱いを簡単にし、C#開発者にとって貴重なツールです。

IronPDFの際立った機能は、すべてのレイアウトとスタイルを保持するHTMLからPDFへの変換機能です。 ウェブコンテンツからPDFを生成するため、レポート、請求書、ドキュメントに最適です。 HTMLファイル、URL、およびHTML文字列を簡単にPDFに変換できます。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

IronPDFの主な機能には以下が含まれます:

• HTMLからPDFへの変換: IronPDFを使用すると、CSSやJavaScriptを含むHTMLテキストからPDFドキュメントを作成できます。 これは、ウェブ開発ツールに精通しており、HTMLとCSSを使用してPDFを作成したい人に特に有用です。
• PDFの生成と操作: ライブラリは、プログラムでPDFドキュメントを作成する機能を提供します。 さらに、テキスト抽出、ウォーターマークの追加、PDFの分割など、既存のPDFを編集する機能を提供します。
• 優れたレンダリング: IronPDFはレンダリングエンジンを使用して、最も高品質なPDF出力を生成し、最終ドキュメントが明瞭さと視覚的整合性を保持することを保証します。
• クロスプラットフォームの互換性: IronPDFは.NET Coreと.NET Frameworkの両方で動作するように設計されており、さまざまなアプリケーションや多様なプラットフォームで使用可能です。
• パフォーマンス最適化: 大規模または複雑なPDFドキュメントを取り扱う際でも、ライブラリは効率的なPDF生成とレンダリングを提供するよう設計されています。

IronPDFのドキュメントについて詳しく知りたい場合は、IronPDFドキュメントをご参照ください。

IronPDFのインストール

まず、パッケージマネージャーコンソールまたはNuGetパッケージマネージャーを使用して、IronPDFライブラリをインストールします:

Install-Package IronPdf

<!a href="/static-assets/pdf/blog/csharp-collection/csharp-collection-2.webp">C# Collection (How It Works For Developers): Figure 2 - Installing IronPDF with the Package Manager Console

NuGetパッケージマネージャーを使用して"IronPDF"パッケージを検索するのも別の選択肢です。 このリストから、IronPDFに関連するすべてのNuGetパッケージの中から必要なパッケージを選択してダウンロードできます。

<!a href="/static-assets/pdf/blog/csharp-collection/csharp-collection-3.webp">C# Collection (How It Works For Developers): Figure 3 - Installing IronPDF with the NuGet Package Manager

IronPDFを使用したコレクションでのドキュメント作成

IronPDFとのインターフェースに入る前に、データ構造と組織においてコレクションが果たす役割を理解することが重要です。 開発者は、コレクションを使用して、グループ化されたオブジェクトを整理して格納し、取り出し、変更することができます。 List、Dictionary<TKey, TValue>、HashSetなど、利用可能なさまざまなタイプの中から、開発者は自分の要求に最も適したコレクションを選ぶことができます。

たとえば、販売取引のリストを含む報告書を作成しなければならないと想像してください。 データは、追加処理および表示の基礎として、Listを使用して効果的に整理できます。

// Define the Transaction class
public class Transaction
{
    public string ProductName { get; set; }
    public decimal Amount { get; set; }
    public DateTime Date { get; set; }
}

// Create a list of transactions
List<Transaction> transactions = new List<Transaction>
{
    new Transaction { ProductName = "Product A", Amount = 100.50m, Date = DateTime.Now.AddDays(-2) },
    new Transaction { ProductName = "Product B", Amount = 75.20m, Date = DateTime.Now.AddDays(-1) },
    // Add more transactions as needed
};

// Define the Transaction class
public class Transaction
{
    public string ProductName { get; set; }
    public decimal Amount { get; set; }
    public DateTime Date { get; set; }
}

// Create a list of transactions
List<Transaction> transactions = new List<Transaction>
{
    new Transaction { ProductName = "Product A", Amount = 100.50m, Date = DateTime.Now.AddDays(-2) },
    new Transaction { ProductName = "Product B", Amount = 75.20m, Date = DateTime.Now.AddDays(-1) },
    // Add more transactions as needed
};

' Define the Transaction class
Public Class Transaction
	Public Property ProductName() As String
	Public Property Amount() As Decimal
	Public Property [Date]() As DateTime
End Class

' Create a list of transactions
Private transactions As New List(Of Transaction) From {
	New Transaction With {
		.ProductName = "Product A",
		.Amount = 100.50D,
		.Date = DateTime.Now.AddDays(-2)
	},
	New Transaction With {
		.ProductName = "Product B",
		.Amount = 75.20D,
		.Date = DateTime.Now.AddDays(-1)
	}
}

PDF内では、各製品名、取引金額、および日付を一覧にしたシンプルなテーブルを作成します。

using IronPdf;

// Create a PDF document renderer
var pdfDocument = new HtmlToPdf();

// HTML content with a table populated by data from the 'transactions' list
string htmlContent = "<table><tr><th>Product Name</th><th>Amount</th><th>Date</th></tr>";
foreach (var transaction in transactions)
{
    htmlContent += $"<tr><td>{transaction.ProductName}</td><td>{transaction.Amount}</td><td>{transaction.Date.ToShortDateString()}</td></tr>";
}
htmlContent += "</table>";

// Convert HTML to PDF
PdfDocument pdf = pdfDocument.RenderHtmlAsPdf(htmlContent);

// Specify the file path to save the PDF
string pdfFilePath = "transactions_report.pdf";
pdf.SaveAs(pdfFilePath);

using IronPdf;

// Create a PDF document renderer
var pdfDocument = new HtmlToPdf();

// HTML content with a table populated by data from the 'transactions' list
string htmlContent = "<table><tr><th>Product Name</th><th>Amount</th><th>Date</th></tr>";
foreach (var transaction in transactions)
{
    htmlContent += $"<tr><td>{transaction.ProductName}</td><td>{transaction.Amount}</td><td>{transaction.Date.ToShortDateString()}</td></tr>";
}
htmlContent += "</table>";

// Convert HTML to PDF
PdfDocument pdf = pdfDocument.RenderHtmlAsPdf(htmlContent);

// Specify the file path to save the PDF
string pdfFilePath = "transactions_report.pdf";
pdf.SaveAs(pdfFilePath);

Imports IronPdf

' Create a PDF document renderer
Private pdfDocument = New HtmlToPdf()

' HTML content with a table populated by data from the 'transactions' list
Private htmlContent As String = "<table><tr><th>Product Name</th><th>Amount</th><th>Date</th></tr>"
For Each transaction In transactions
	htmlContent &= $"<tr><td>{transaction.ProductName}</td><td>{transaction.Amount}</td><td>{transaction.Date.ToShortDateString()}</td></tr>"
Next transaction
htmlContent &= "</table>"

' Convert HTML to PDF
Dim pdf As PdfDocument = pdfDocument.RenderHtmlAsPdf(htmlContent)

' Specify the file path to save the PDF
Dim pdfFilePath As String = "transactions_report.pdf"
pdf.SaveAs(pdfFilePath)

一度生成されたPDFドキュメントは、開発者はそれをディスクに保存したり、ユーザーに表示したりすることができます。 IronPDFは、ブラウザストリーミング、ファイル保存、クラウドストレージ統合など、いくつかの出力オプションを提供します。

<!a href="/static-assets/pdf/blog/csharp-collection/csharp-collection-4.webp">C# Collection (How It Works For Developers): Figure 4 - Outputted PDF from the previous code

プログラムで生成された上記のコードに基づいて出力されたPDFです。 コードについて詳しく知りたい場合は、Using HTML to Create a PDF Exampleを参照してください。