Message icon
フッターコンテンツにスキップ
  1. IronPDF
  2. IronPDF ブログ
  3. .NETヘルプ
  4. C# ObservableCollection
.NETヘルプ

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

Curtis Chau
Curtis Chau
更新日:

C#では、ObservableCollectionは、アイテムの追加、削除、変更が行われた際にリスナーに自動的に通知を行う強力なデータ構造です。 これは、UIやレポートでリアルタイムの変更を反映する必要がある動的なデータコレクションシナリオに特に役立ちます。 IronPDFと組み合わせることで、この強力なコレクションを使用して、ライブデータに基づいた動的なPDFを生成することができます。

IronPDFは、C#でPDFを生成するための堅牢なライブラリです。 HTMLからPDFへの変換機能により、請求書、レポート、その他のリアルタイムデータに基づくドキュメントを簡単に作成できます。 この記事では、ObservableCollectionクラスをIronPDFと統合し、データバインディングを活用して、データの変化に応じて動的に更新されるPDFを生成する方法を紹介します。

ObservableCollectionの理解

ObservableCollectionとは何ですか？

ObservableCollectionは、C#でINotifyCollectionChangedインターフェイスを実装したクラスで、アイテムの追加、削除、変更が行われた際に通知を提供します。 これは、コレクションへの変更が自動的にUIに更新を引き起こすWPFのようなUIアプリケーションでのデータバインディングによく使用されます。 Listのような他のコレクションとは異なり、ObservableCollectionは組み込みのイベント通知を提供するため、データがリアルタイムで反映される必要があるシナリオに最適です。

ObservableCollectionは全体のコレクションの変更を自動的に処理するため、アプリケーションで動的なデータコレクションを簡単に管理および表示できます。

一般的な使用例

  • UIコンポーネントとのバインド: 例えば、WPFでは、ObservableCollectionはListView、DataGrid、ComboBoxのようなコントロールにデータをバインドするためによく使用されます。 基底コレクションが変更されると、UIは自動的に更新されます。
  • リアルタイム更新: データが頻繁に変更される場合、ObservableCollectionはUIが常に同期されるようにします。 例えば、リアルタイムでデータエントリがコレクションに追加されるライブレポートに使用でき、レポートはそれに応じて更新されます。
  • 動的な変更: アプリケーションがユーザーによるデータの追加、削除、変更を許可する場合、ObservableCollectionを使用して、UIや他のコンポーネントにそれらの変更を自動的に反映することができます。

IronPDFとの作業

IronPDFの概要

C# ObservableCollection（開発者向けの動作方法）：図1

この記事の冒頭で述べたように、IronPDFは.NET PDF生成ライブラリで、PDFドキュメントの作成、修正、レンダリングを容易にします。 他のPDFライブラリとは異なり、IronPDFは、HTMLをPDFに変換したり、透かしを追加したり、既存のPDFを操作したりする機能など、PDFの操作を簡素化する豊富な機能セットを提供します。

IronPDFは、HTML、画像、普通のテキストなど、さまざまなデータソースからのPDFレンダリングも可能で、動的なデータを表示する必要がある場合に特に役立ちます。 IronPDFのAPIを使用すると、詳細なレイアウト、テーブル、画像、スタイルを含む高品質なPDFを生成することができます。

IronPDFの設定

IronPDFを使い始めるには、NuGetを介してライブラリをインストールする必要があります。 パッケージマネージャーコンソールで以下のコマンドを実行して、プロジェクトに追加できます。

Install-Package IronPdf

インストール後、IronPDFを初期化して、その強力な機能を使用できます。 この記事では、ObservableCollectionの動的データからPDFを生成することに焦点を当てます。

ObservableCollectionとIronPDFの統合

ユースケース: ObservableCollectionからの動的PDF生成

アイテムリストがObservableCollectionに格納されている請求書PDFを生成する必要があるシナリオを考えてみましょう。 コレクションにアイテムが追加または削除されると、データの現在の状態を反映するためにPDFが自動的に再生成される必要があります。

この作業において、ObservableCollectionは請求書内のアイテムを管理する簡単な方法を提供し、IronPDFは請求書をPDFフォーマットで生成およびエクスポートすることを可能にします。

PDFコンテンツへのデータバインディング

ObservableCollectionのデータをPDFにバインドするためには、コレクションをループし、そのアイテムをPDFコンテンツに追加する必要があります。 IronPDFは、テーブルを作成したり、テキストを追加したり、レイアウトをカスタマイズしたりする方法を提供しており、データを構造化された形式で表示するのを容易にします。

例えば、いくつかのアイテムがある請求書の場合、ObservableCollectionをループして、各アイテムをドキュメント内のテーブルやリストに追加することで、動的にPDFを生成できます。 IronPDFはフォントの調整、境界線、ロゴやバーコードのような画像の挿入など、高度なカスタマイズも可能にします。

例1: ObservableCollectionを使用したPDFの生成

この仕組みを理解するための簡単な例を見てみましょう。 人のコレクション（Personクラスで表される）を持っていて、これらの人々の詳細を反映したPDFを生成したいとします。 コレクションに新しい人が追加されるたびに、PDFは自動的に更新されます。

Personクラスの例

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}
public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}
Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class
$vbLabelText   $csharpLabel

このケースでは、PersonクラスにはNameやAgeといった基本的なプロパティが含まれています。 このクラスをObservableCollectionと組み合わせて、動的にPDFを生成します。

ObservableCollectionの作成

using System.Collections.ObjectModel;

var collection = new ObservableCollection<Person>
{
    new Person { Name = "John Doe", Age = 30 },
    new Person { Name = "Jane Smith", Age = 28 }
};
using System.Collections.ObjectModel;

var collection = new ObservableCollection<Person>
{
    new Person { Name = "John Doe", Age = 30 },
    new Person { Name = "Jane Smith", Age = 28 }
};
Imports System.Collections.ObjectModel

Private collection = New ObservableCollection(Of Person) From {
	New Person With {
		.Name = "John Doe",
		.Age = 30
	},
	New Person With {
		.Name = "Jane Smith",
		.Age = 28
	}
}
$vbLabelText   $csharpLabel

このObservableCollectionは、NameとAgeを持つPersonオブジェクトのコレクションを含んでいます。 アイテムが追加または削除されると、イベントハンドラがトリガーされ、PDFを動的に更新します。

コレクション変更のためのイベントハンドラーの追加

この例では、コレクションが変わるたびにPDFを自動的に再生成するために、ObservableCollectionクラスのCollectionChangedイベントに登録します。 これにより、Personオブジェクトの追加や削除といった変更に対応できます。

// Subscribe to the ObservableCollection's CollectionChanged event
collection.CollectionChanged += (object sender, System.Collections.Specialized.NotifyCollectionChangedEventArgs e) =>
{
    // Regenerate the PDF whenever the collection changes
    GeneratePersonPDF(collection);
};
// Subscribe to the ObservableCollection's CollectionChanged event
collection.CollectionChanged += (object sender, System.Collections.Specialized.NotifyCollectionChangedEventArgs e) =>
{
    // Regenerate the PDF whenever the collection changes
    GeneratePersonPDF(collection);
};
' Subscribe to the ObservableCollection's CollectionChanged event
AddHandler collection.CollectionChanged, Sub(sender As Object, e As System.Collections.Specialized.NotifyCollectionChangedEventArgs)
	' Regenerate the PDF whenever the collection changes
	GeneratePersonPDF(collection)
End Sub
$vbLabelText   $csharpLabel

コレクションへの新しい人の追加

新しいPersonをコレクションに追加すると、コレクション全体がイベントハンドラをトリガーして、PDFを再生成します。 このアプローチは、人物のリスト全体の変更を自動的に処理します。

// Adding a new person to the collection
collection.Add(new Person { Name = "Alice Brown", Age = 32 });
// Adding a new person to the collection
collection.Add(new Person { Name = "Alice Brown", Age = 32 });
' Adding a new person to the collection
collection.Add(New Person With {
	.Name = "Alice Brown",
	.Age = 32
})
$vbLabelText   $csharpLabel

コレクションに新しい人を追加するたびに、PDFは再生成され、新しいエントリを含みます。

年齢プロパティのバインディング

また、Personの年齢プロパティを外部システム（UIやアプリケーションの他の部分など）にバインドし、変更を自動的に反映することもできます。

以下はPersonクラスで年齢プロパティがバインドされる例です。

public class Person
{
    public string Name { get; set; }
    private int _age;
    public int Age 
    {
        get { return _age; }
        set
        {
            _age = value;
            // Raise property changed event here if using data binding
        }
    }
}
public class Person
{
    public string Name { get; set; }
    private int _age;
    public int Age 
    {
        get { return _age; }
        set
        {
            _age = value;
            // Raise property changed event here if using data binding
        }
    }
}
Public Class Person
	Public Property Name() As String
	Private _age As Integer
	Public Property Age() As Integer
		Get
			Return _age
		End Get
		Set(ByVal value As Integer)
			_age = value
			' Raise property changed event here if using data binding
		End Set
	End Property
End Class
$vbLabelText   $csharpLabel

ObservableCollectionをバインディングで使用

年齢のバインディングをUI要素に使用し、年齢値を更新して、コレクション内での変更がどのように反映されるかを観察する方法を示します。

ObservableCollection<Person> people = new ObservableCollection<Person>
{
    new Person { Name = "John", Age = 30 },
    new Person { Name = "Jane", Age = 28 }
};
// Binding the Age of the first person to a UI element (pseudo-code)
someUIElement.Text = people[0].Age.ToString();
ObservableCollection<Person> people = new ObservableCollection<Person>
{
    new Person { Name = "John", Age = 30 },
    new Person { Name = "Jane", Age = 28 }
};
// Binding the Age of the first person to a UI element (pseudo-code)
someUIElement.Text = people[0].Age.ToString();
Dim people As New ObservableCollection(Of Person) From {
	New Person With {
		.Name = "John",
		.Age = 30
	},
	New Person With {
		.Name = "Jane",
		.Age = 28
	}
}
' Binding the Age of the first person to a UI element (pseudo-code)
someUIElement.Text = people(0).Age.ToString()
$vbLabelText   $csharpLabel

IronPDFを使用したPDFの生成

ObservableCollectionを設定し、イベントハンドラを追加したので、次は動的な人々のコレクションを反映するPDFを生成することに焦点を当てましょう。

using IronPdf;

public void GeneratePersonPDF(ObservableCollection<Person> people)
{
    var pdf = new ChromePdfRenderer();  // Initialize IronPDF's ChromePdfRenderer class
    // Create HTML content representing the people in the collection
    var htmlContent = "<h1>People Information</h1><table border='1' cellpadding='5' cellspacing='0'>" +
                      "<tr><th>Name</th><th>Age</th></tr>";
    foreach (var person in people)
    {
        htmlContent += $"<tr><td>{person.Name}</td><td>{person.Age}</td></tr>";
    }

    htmlContent += "</table>";
    // Convert the HTML content to a PDF
    var pdfDocument = pdf.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to disk
    pdfDocument.SaveAs("PeopleInformation.pdf");
}
using IronPdf;

public void GeneratePersonPDF(ObservableCollection<Person> people)
{
    var pdf = new ChromePdfRenderer();  // Initialize IronPDF's ChromePdfRenderer class
    // Create HTML content representing the people in the collection
    var htmlContent = "<h1>People Information</h1><table border='1' cellpadding='5' cellspacing='0'>" +
                      "<tr><th>Name</th><th>Age</th></tr>";
    foreach (var person in people)
    {
        htmlContent += $"<tr><td>{person.Name}</td><td>{person.Age}</td></tr>";
    }

    htmlContent += "</table>";
    // Convert the HTML content to a PDF
    var pdfDocument = pdf.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to disk
    pdfDocument.SaveAs("PeopleInformation.pdf");
}
Imports IronPdf

Public Sub GeneratePersonPDF(ByVal people As ObservableCollection(Of Person))
	Dim pdf = New ChromePdfRenderer() ' Initialize IronPDF's ChromePdfRenderer class
	' Create HTML content representing the people in the collection
	Dim htmlContent = "<h1>People Information</h1><table border='1' cellpadding='5' cellspacing='0'>" & "<tr><th>Name</th><th>Age</th></tr>"
	For Each person In people
		htmlContent &= $"<tr><td>{person.Name}</td><td>{person.Age}</td></tr>"
	Next person

	htmlContent &= "</table>"
	' Convert the HTML content to a PDF
	Dim pdfDocument = pdf.RenderHtmlAsPdf(htmlContent)
	' Save the generated PDF to disk
	pdfDocument.SaveAs("PeopleInformation.pdf")
End Sub
$vbLabelText   $csharpLabel

例2: ObservableCollectionからPDFインボイスの生成

ObservableCollectionの請求書アイテムからPDFを生成する方法の例を以下に示します。

ステップ1: サンプル請求書アイテムクラス

このクラスは、アイテム名、数量、価格、合計価格のプロパティを持つ請求書アイテムを表します。

public class InvoiceItem
{
    public string ItemName { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
    public decimal Total => Quantity * Price;
}
public class InvoiceItem
{
    public string ItemName { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
    public decimal Total => Quantity * Price;
}
Public Class InvoiceItem
	Public Property ItemName() As String
	Public Property Quantity() As Integer
	Public Property Price() As Decimal
	Public ReadOnly Property Total() As Decimal
		Get
			Return Quantity * Price
		End Get
	End Property
End Class
$vbLabelText   $csharpLabel

ステップ2: サンプルObservableCollection

この例では、いくつかの請求書アイテムを含むObservableCollectionを初期化します。 このコレクションのアイテムを動的に追加、削除、または変更できます。

ObservableCollection<InvoiceItem> invoiceItems = new ObservableCollection<InvoiceItem>
{
    new InvoiceItem { ItemName = "Item 1", Quantity = 2, Price = 10.00m },
    new InvoiceItem { ItemName = "Item 2", Quantity = 1, Price = 25.00m },
    new InvoiceItem { ItemName = "Item 3", Quantity = 5, Price = 5.00m }
};
ObservableCollection<InvoiceItem> invoiceItems = new ObservableCollection<InvoiceItem>
{
    new InvoiceItem { ItemName = "Item 1", Quantity = 2, Price = 10.00m },
    new InvoiceItem { ItemName = "Item 2", Quantity = 1, Price = 25.00m },
    new InvoiceItem { ItemName = "Item 3", Quantity = 5, Price = 5.00m }
};
Dim invoiceItems As New ObservableCollection(Of InvoiceItem) From {
	New InvoiceItem With {
		.ItemName = "Item 1",
		.Quantity = 2,
		.Price = 10.00D
	},
	New InvoiceItem With {
		.ItemName = "Item 2",
		.Quantity = 1,
		.Price = 25.00D
	},
	New InvoiceItem With {
		.ItemName = "Item 3",
		.Quantity = 5,
		.Price = 5.00D
	}
}
$vbLabelText   $csharpLabel

ステップ3: IronPDFを使用したPDFの生成

ここでは、PDFを生成する関数を作成します。 この関数は、ObservableCollectionのデータをHTMLに変換し、それをIronPDFを使用してPDFとしてレンダリングします。

public void GenerateInvoicePDF(ObservableCollection<InvoiceItem> items)
{
    var pdf = new ChromePdfRenderer();  // Initialize IronPDF's ChromePdfRenderer class
    // Create HTML content representing the invoice
    var htmlContent = "<h1>Invoice</h1><table border='1' cellpadding='5' cellspacing='0'>" +
                      "<tr><th>Item</th><th>Quantity</th><th>Price</th><th>Total</th></tr>";
    foreach (var item in items)
    {
        htmlContent += $"<tr><td>{item.ItemName}</td><td>{item.Quantity}</td><td>{item.Price:C}</td><td>{item.Total:C}</td></tr>";
    }
    htmlContent += "</table>";
    // Convert the HTML content to a PDF
    var pdfDocument = pdf.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to disk
    pdfDocument.SaveAs("Invoice.pdf");
}
public void GenerateInvoicePDF(ObservableCollection<InvoiceItem> items)
{
    var pdf = new ChromePdfRenderer();  // Initialize IronPDF's ChromePdfRenderer class
    // Create HTML content representing the invoice
    var htmlContent = "<h1>Invoice</h1><table border='1' cellpadding='5' cellspacing='0'>" +
                      "<tr><th>Item</th><th>Quantity</th><th>Price</th><th>Total</th></tr>";
    foreach (var item in items)
    {
        htmlContent += $"<tr><td>{item.ItemName}</td><td>{item.Quantity}</td><td>{item.Price:C}</td><td>{item.Total:C}</td></tr>";
    }
    htmlContent += "</table>";
    // Convert the HTML content to a PDF
    var pdfDocument = pdf.RenderHtmlAsPdf(htmlContent);
    // Save the generated PDF to disk
    pdfDocument.SaveAs("Invoice.pdf");
}
Public Sub GenerateInvoicePDF(ByVal items As ObservableCollection(Of InvoiceItem))
	Dim pdf = New ChromePdfRenderer() ' Initialize IronPDF's ChromePdfRenderer class
	' Create HTML content representing the invoice
	Dim htmlContent = "<h1>Invoice</h1><table border='1' cellpadding='5' cellspacing='0'>" & "<tr><th>Item</th><th>Quantity</th><th>Price</th><th>Total</th></tr>"
	For Each item In items
		htmlContent &= $"<tr><td>{item.ItemName}</td><td>{item.Quantity}</td><td>{item.Price:C}</td><td>{item.Total:C}</td></tr>"
	Next item
	htmlContent &= "</table>"
	' Convert the HTML content to a PDF
	Dim pdfDocument = pdf.RenderHtmlAsPdf(htmlContent)
	' Save the generated PDF to disk
	pdfDocument.SaveAs("Invoice.pdf")
End Sub
$vbLabelText   $csharpLabel

ステップ4: CollectionChangedイベントへの登録

ObservableCollectionは変更を自動的に通知するため、コレクションが更新されるたびにPDFを簡単に再生成できます。 例えば、アイテムが追加または削除された場合、PDFは更新データで再生成できます。

CollectionChangedイベントに登録し、コレクションが変わるたびにPDFを再生成する方法を次に示します。

// Subscribe to the ObservableCollection's CollectionChanged event
invoiceItems.CollectionChanged += (sender, e) =>
{
    // Regenerate the PDF whenever the collection changes
    GenerateInvoicePDF(invoiceItems);
};
// Subscribe to the ObservableCollection's CollectionChanged event
invoiceItems.CollectionChanged += (sender, e) =>
{
    // Regenerate the PDF whenever the collection changes
    GenerateInvoicePDF(invoiceItems);
};
' Subscribe to the ObservableCollection's CollectionChanged event
AddHandler invoiceItems.CollectionChanged, Sub(sender, e)
	' Regenerate the PDF whenever the collection changes
	GenerateInvoicePDF(invoiceItems)
End Sub
$vbLabelText   $csharpLabel

ステップ5: アイテムの追加とテスト

ObservableCollectionに新しいアイテムを追加してPDFが自動的に再生成される様子を観察することでテストを行うことができます。

// Adding a new item to the ObservableCollection
invoiceItems.Add(new InvoiceItem { ItemName = "Item 4", Quantity = 3, Price = 12.50m });
// Adding a new item to the ObservableCollection
invoiceItems.Add(new InvoiceItem { ItemName = "Item 4", Quantity = 3, Price = 12.50m });
' Adding a new item to the ObservableCollection
invoiceItems.Add(New InvoiceItem With {
	.ItemName = "Item 4",
	.Quantity = 3,
	.Price = 12.50D
})
$vbLabelText   $csharpLabel

完全なコード例

using System;
using System.Collections.ObjectModel;
using IronPdf;

public class InvoiceItem
{
    public string ItemName { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
    // Property to calculate the total price for each item
    public decimal Total => Quantity * Price;
}
public class InvoiceGenerator
{
    // Function to generate the invoice PDF
    public void GenerateInvoicePDF(ObservableCollection<InvoiceItem> items)
    {
        var pdf = new ChromePdfRenderer();  // Initialize IronPDF's ChromePdfRenderer class
        // Create HTML content representing the invoice
        var htmlContent = "<h1>Invoice</h1><table border='1' cellpadding='5' cellspacing='0'>" +
                          "<tr><th>Item</th><th>Quantity</th><th>Price</th><th>Total</th></tr>";
        foreach (var item in items)
        {
            htmlContent += $"<tr><td>{item.ItemName}</td><td>{item.Quantity}</td><td>{item.Price:C}</td><td>{item.Total:C}</td></tr>";
        }
        htmlContent += "</table>";
        // Convert the HTML content to a PDF
        var pdfDocument = pdf.RenderHtmlAsPdf(htmlContent);
        // Save the generated PDF to disk
        pdfDocument.SaveAs("Invoice.pdf");
    }

    // Main function to test the code
    public static void Main(string[] args)
    {
        var invoiceItems = new ObservableCollection<InvoiceItem>
        {
            new InvoiceItem { ItemName = "Item 1", Quantity = 2, Price = 10.00m },
            new InvoiceItem { ItemName = "Item 2", Quantity = 1, Price = 25.00m },
            new InvoiceItem { ItemName = "Item 3", Quantity = 5, Price = 5.00m }
        };

        var invoiceGenerator = new InvoiceGenerator();

        // Subscribe to the ObservableCollection's CollectionChanged event
        invoiceItems.CollectionChanged += (sender, e) =>
        {
            // Regenerate the PDF whenever the collection changes
            invoiceGenerator.GenerateInvoicePDF(invoiceItems);
        };

        // Generate initial PDF
        invoiceGenerator.GenerateInvoicePDF(invoiceItems);

        // Add a new item to the collection and automatically regenerate the PDF
        invoiceItems.Add(new InvoiceItem { ItemName = "Item 4", Quantity = 3, Price = 12.50m });

        // Remove an item and see the PDF update
        invoiceItems.RemoveAt(0);
    }
}
using System;
using System.Collections.ObjectModel;
using IronPdf;

public class InvoiceItem
{
    public string ItemName { get; set; }
    public int Quantity { get; set; }
    public decimal Price { get; set; }
    // Property to calculate the total price for each item
    public decimal Total => Quantity * Price;
}
public class InvoiceGenerator
{
    // Function to generate the invoice PDF
    public void GenerateInvoicePDF(ObservableCollection<InvoiceItem> items)
    {
        var pdf = new ChromePdfRenderer();  // Initialize IronPDF's ChromePdfRenderer class
        // Create HTML content representing the invoice
        var htmlContent = "<h1>Invoice</h1><table border='1' cellpadding='5' cellspacing='0'>" +
                          "<tr><th>Item</th><th>Quantity</th><th>Price</th><th>Total</th></tr>";
        foreach (var item in items)
        {
            htmlContent += $"<tr><td>{item.ItemName}</td><td>{item.Quantity}</td><td>{item.Price:C}</td><td>{item.Total:C}</td></tr>";
        }
        htmlContent += "</table>";
        // Convert the HTML content to a PDF
        var pdfDocument = pdf.RenderHtmlAsPdf(htmlContent);
        // Save the generated PDF to disk
        pdfDocument.SaveAs("Invoice.pdf");
    }

    // Main function to test the code
    public static void Main(string[] args)
    {
        var invoiceItems = new ObservableCollection<InvoiceItem>
        {
            new InvoiceItem { ItemName = "Item 1", Quantity = 2, Price = 10.00m },
            new InvoiceItem { ItemName = "Item 2", Quantity = 1, Price = 25.00m },
            new InvoiceItem { ItemName = "Item 3", Quantity = 5, Price = 5.00m }
        };

        var invoiceGenerator = new InvoiceGenerator();

        // Subscribe to the ObservableCollection's CollectionChanged event
        invoiceItems.CollectionChanged += (sender, e) =>
        {
            // Regenerate the PDF whenever the collection changes
            invoiceGenerator.GenerateInvoicePDF(invoiceItems);
        };

        // Generate initial PDF
        invoiceGenerator.GenerateInvoicePDF(invoiceItems);

        // Add a new item to the collection and automatically regenerate the PDF
        invoiceItems.Add(new InvoiceItem { ItemName = "Item 4", Quantity = 3, Price = 12.50m });

        // Remove an item and see the PDF update
        invoiceItems.RemoveAt(0);
    }
}
Imports System
Imports System.Collections.ObjectModel
Imports IronPdf

Public Class InvoiceItem
	Public Property ItemName() As String
	Public Property Quantity() As Integer
	Public Property Price() As Decimal
	' Property to calculate the total price for each item
	Public ReadOnly Property Total() As Decimal
		Get
			Return Quantity * Price
		End Get
	End Property
End Class
Public Class InvoiceGenerator
	' Function to generate the invoice PDF
	Public Sub GenerateInvoicePDF(ByVal items As ObservableCollection(Of InvoiceItem))
		Dim pdf = New ChromePdfRenderer() ' Initialize IronPDF's ChromePdfRenderer class
		' Create HTML content representing the invoice
		Dim htmlContent = "<h1>Invoice</h1><table border='1' cellpadding='5' cellspacing='0'>" & "<tr><th>Item</th><th>Quantity</th><th>Price</th><th>Total</th></tr>"
		For Each item In items
			htmlContent &= $"<tr><td>{item.ItemName}</td><td>{item.Quantity}</td><td>{item.Price:C}</td><td>{item.Total:C}</td></tr>"
		Next item
		htmlContent &= "</table>"
		' Convert the HTML content to a PDF
		Dim pdfDocument = pdf.RenderHtmlAsPdf(htmlContent)
		' Save the generated PDF to disk
		pdfDocument.SaveAs("Invoice.pdf")
	End Sub

	' Main function to test the code
	Public Shared Sub Main(ByVal args() As String)
		Dim invoiceItems = New ObservableCollection(Of InvoiceItem) From {
			New InvoiceItem With {
				.ItemName = "Item 1",
				.Quantity = 2,
				.Price = 10.00D
			},
			New InvoiceItem With {
				.ItemName = "Item 2",
				.Quantity = 1,
				.Price = 25.00D
			},
			New InvoiceItem With {
				.ItemName = "Item 3",
				.Quantity = 5,
				.Price = 5.00D
			}
		}

'INSTANT VB NOTE: The variable invoiceGenerator was renamed since it may cause conflicts with calls to static members of the user-defined type with this name:
		Dim invoiceGenerator_Conflict As New InvoiceGenerator()

		' Subscribe to the ObservableCollection's CollectionChanged event
		AddHandler invoiceItems.CollectionChanged, Sub(sender, e)
			' Regenerate the PDF whenever the collection changes
			invoiceGenerator_Conflict.GenerateInvoicePDF(invoiceItems)
		End Sub

		' Generate initial PDF
		invoiceGenerator_Conflict.GenerateInvoicePDF(invoiceItems)

		' Add a new item to the collection and automatically regenerate the PDF
		invoiceItems.Add(New InvoiceItem With {
			.ItemName = "Item 4",
			.Quantity = 3,
			.Price = 12.50D
		})

		' Remove an item and see the PDF update
		invoiceItems.RemoveAt(0)
	End Sub
End Class
$vbLabelText   $csharpLabel

出力

C# ObservableCollection（開発者向けの動作方法）：図2 - 出力PDFファイル

コードが行うこと

  • InvoiceItemクラス: ItemName、Quantity、Price、計算されたTotalのプロパティを持つ請求書アイテムを表します。
  • ObservableCollection: 請求書アイテムのリストを保存するために使用されます。 このコレクションは、アイテムが追加または削除されたときにリスナーに自動的に通知します。
  • GenerateInvoicePDF: インボイスを表現するHTMLコンテンツを作成し、それをIronPDFでPDFに変換します。
  • CollectionChanged: ObservableCollectionのイベントは、コレクションが変わるたびにPDFを再生成するように処理され、PDF生成を動的にします。
  • テスト: Mainメソッドは、ObservableCollectionにアイテムが追加または削除されるとPDFの再生成がトリガーされる様子を示します。

パフォーマンスへの考慮

大規模なコレクションの取り扱い

大規模なObservableCollectionインスタンスを扱う場合、パフォーマンスが問題になる可能性があります。 コレクションが変わるたびにPDFを再生成するのは、多くのアイテムがある場合、リソース集約的かもしれません。 これを軽減するために、バッチ処理を検討したり、ページングのようなテクニックを採用して、PDF生成プロセスの過負荷を回避することを検討してください。

効率的なPDFレンダリング

PDFレンダリングを効率的にするために、次のヒントを念頭に置いてください。

  • 不必要な再レンダリングを最小限に抑える: データが大きく変わったときだけPDFを再生成する（例: アイテムが追加または削除された場合）。
  • テーブルレイアウトを最適化する: 大規模なデータセットをレンダリングする際には、それを小さく、管理可能なセクションに分割してレンダリング時間を改善します。
  • キャッシュを使用する: 静的または変化の少ないデータに対して、以前に生成されたPDFをキャッシュします。

結論

C#のObservableCollectionとIronPDFを組み合わせることで、アプリケーションのデータにリアルタイムで変更を反映する動的なPDFを簡単に生成することができます。 請求書、レポート、その他のドキュメントを生成する際、このアプローチにより基礎となるコレクションが変わるたびに、自動的にPDFコンテンツが更新されます。

ObservableCollectionの統合により、アプリケーションは常に最新の状態を保つことができ、IronPDFは高品質なPDFのレンダリングを行います。 この記事で説明したベストプラクティスとパフォーマンスのヒントに従うことで、.NETアプリケーションのためのシームレスなPDF生成体験を作成できます。

IronPDFを試してみたいですか？ Download the free trial today to elevate your C# PDF projects, and be sure to check out the extensive documentation section to see more of this library in action.

よくある質問

C# の ObservableCollection とは何ですか？

ObservableCollection は、C# 内のクラスであり、INotifyCollectionChanged インターフェイスを実装します。項目が追加、削除、または変更されたときに通知を提供するため、リアルタイムの更新が必要な UI アプリケーションでのデータ バインディングに理想的です。

C# で動的データから PDF を生成するにはどうすればよいですか？

IronPDF を使用すると、C# の ObservableCollection を活用して動的データから PDF を生成できます。コレクションが更新されると、現在のデータ状態を反映するために PDF を自動的に再生成できます。

PDF 生成に ObservableCollection を使用することの利点は何ですか？

ObservableCollection はリアルタイムのデータ追跡を可能にし、ライブデータの変更を反映する必要がある PDF を生成する際に役立ちます。IronPDF と組み合わせることで、データの更新が PDF 出力に迅速に反映されることを保証します。

ObservableCollection からのデータを PDF にバインドするにはどうすればよいですか？

ObservableCollection から PDF にデータをバインドするには、コレクション項目を反復処理し、それらをテーブルやリストなどの構造化要素として PDF に追加するために IronPDF のメソッドを使用します。これにより、PDF コンテンツは常にデータと同期されます。

C# の ObservableCollection を使用して PDF を生成する一般的なユースケースは何ですか？

一般的なユースケースは、項目の ObservableCollection から請求書を生成することです。コレクションに項目が追加または削除されると、PDF 請求書を再生成して、現在の項目リストを正確に反映し、最新のドキュメントを確保できます。

IronPDF は C# で HTML から PDF への変換をどのように処理しますか？

IronPDF は RenderHtmlAsPdf や RenderHtmlFileAsPdf などのメソッドを使用して HTML を PDF に変換できます。これにより、開発者はウェブページや HTML 文字列から PDF を作成し、動的コンテンツのレンダリングを促進できます。

PDF 生成のための大規模な ObservableCollection を扱う際に考慮すべきことは何ですか?

大規模なコレクションを扱う場合、ページネーション、バッチ更新、およびレイアウトの最適化を使用してパフォーマンスの問題を回避してください。IronPDF のキャッシングおよびレンダリングの最適化により、大量データを効率的に管理することもできます。

IronPDF は .NET アプリケーションでどのように生産性を向上させますか？

IronPDF は、詳細なレイアウトのカスタマイズ、HTML から PDF への変換、さまざまなデータ ソースとの統合など、PDF 作成のための強力な機能を提供することで生産性を向上させます。複雑な PDF タスクを単純化し、開発者がコア アプリケーション ロジックに集中できるようにします。

Curtis Chau
Curtis Chau
  今すぐエンジニアリングチームとチャット
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

関連する記事

30日間の無料体験 → 完全な製品。制限なし。クレジットカード不要。 無料トライアルを開始