NET MAUI で XAML を PDF に変換する方法

C# MAUI で XAML を PDF に変換する

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF を使用すると、わずか数行のコードで .NET MAUI アプリケーションで XAML ページを PDF に変換できます。 RenderContentPageToPdfメソッドを使用すると、MAUI アプリケーションの UI をデスクトップおよび Web プラットフォーム用のプロフェッショナルな PDF ドキュメントに変更できます。

.NET MAUI (マルチプラットフォーム アプリ UI) は、ネイティブ デバイス アプリケーションを構築するためのクロスプラットフォーム フレームワークです。 Xamarin.Forms から拡張され、統一された .NET 6 エコシステムの一部です。 これにより、.NET アプリケーション開発者は、共通の UI コンポーネントと単一のコードベースを使用して、デスクトップ、Web、モバイル プラットフォーム用のアプリケーションを作成できます。 MAUI では、必要に応じてプラットフォーム固有のコードとリソースを追加することもできます。

IronPDF を使用すると、MAUI ページから PDF ドキュメントを生成できるため、これらのアプリケーションで PDF ファイル/ページを作成できるようになります。 WindowsでもmacOSでも、IronPDFは一貫したPDF生成機能を提供します。 ただし、IronPdfは現在モバイルプラットフォームをサポートしていません。

MAUI アプリケーションの PDF 生成プロセスでは、IronPDF の Chrome レンダリング エンジンが使用されるため、XAML レイアウトが正確に PDF 形式に変換されます。 このため、レポートや請求書の作成、またはMAUIアプリケーションのユーザーインターフェースの視覚的整合性を維持する必要がある文書の作成に最適です。

クイックスタート: .NET MAUI で IronPDF を使用して XAML を PDF に変換する

IronPDFを使用して.NET MAUIでXAMLページをPDFに変換します。 わずか数行のコードで、MAUI アプリケーションのコンテンツをプロ品質の PDF ドキュメントに変更できます。 このガイドでは、IronPDF の効率的なレンダリング機能を使用してすぐに使い始めることができる簡単な例を示します。 手順に従って、PDF 生成をデスクトップ アプリケーションや Web アプリケーションにスムーズに統合します。

var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
$vbLabelText   $csharpLabel

最小限のワークフロー(5ステップ)

  1. MAUI用のIronPDF C#ライブラリをダウンロードする
  2. MainPage.xaml.csファイルをRenderContentPageToPdfメソッドを使用するように変更する
  3. MainPage.xamlファイルのボタンを更新して、新しい関数をトリガーします。
  4. PDF文書をエクスポートするか、PDFビューアを使用してMAUIアプリで表示します。
  5. すぐに使えるサンプルMAUIプロジェクトをダウンロードする

MAUIでIronPDFを使うにはどのような拡張パッケージが必要ですか?

IronPdf.Extensions.Maui パッケージは IronPdf メインパッケージの拡張です。 拡張機能なので、MAUIアプリケーションのコンテンツページをPDFドキュメントにレンダリングするにはIronPDFメインパッケージが必要です。 この拡張パッケージは、特に MAUI の XAML ベースの UI フレームワークと IronPDF の PDF 生成機能の間のギャップを埋めます。

この拡張パッケージは、MAUI ContentPageオブジェクトをPDFとしてレンダリング可能なHTMLに変換します。 カスタム余白カスタム用紙サイズPDF圧縮のようなIronPDFの高度な機能へのアクセスを提供しながら、MAUIページのレイアウトとスタイルを保持します。

Install-Package IronPdf.Extensions.Maui
Install-Package IronPdf.Extensions.Maui
SHELL

拡張パッケージをインストールすると、MAUIページを変換する鍵となるRenderContentPageToPdfメソッドにアクセスできるようになります。 この方法は、パフォーマンスを最適化し、変換プロセス中にXAMLレイアウトの視覚的な忠実性を維持します。

MAUIページをPDFにレンダリングするには?

どのコードファイルを最初に修正すべきですか?

  • MainPage.xamlファイルから、そのコードファイルであるMainPage.xaml.csに移動します。
  • OnCounterClicked という名前の関数を PrintToPdf に変更します。 以下のコードサンプルを使用します。

MAUI ページを PDF に変換するには、RenderContentPageToPdf メソッドを使用します。 このメソッドは ChromePdfRenderer クラスをインスタンス化することでアクセスできます。 このメソッドは PdfDocument オブジェクトを提供し、SaveAs メソッドまたは PDF ビューアを使用して保存または表示できます。MAUI での PDF 表示

ChromePdfRenderer<//code> クラスは、<code>RenderingOptions プロパティを通じて、広範なカスタマイズ オプションを提供します。 ページの余白、用紙の向き、JavaScriptの実行の有効化などを設定できます。 これらのオプションは、PDF出力がお客様の要件に正確に一致することを保証します。

:path=/static-assets/pdf/content-code-examples/how-to/xaml-to-pdf-maui-mainpage-xaml-cs.cs
using IronPdf.Extensions.Maui;

namespace mauiSample;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private void PrintToPdf(object sender, EventArgs e)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Apply HTML header
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<h1>Header</h1>",
        };

        // Render PDF from Maui Page
        PdfDocument pdf = renderer.RenderContentPageToPdf<MainPage, App>().Result;

        pdf.SaveAs(@"C:\Users\lyty1\Downloads\contentPageToPdf.pdf");
    }
}
$vbLabelText   $csharpLabel

さらにお気づきのように、XAML からレンダリングすることで、RenderingOptions で利用可能なすべての機能に完全にアクセスできるようになります。 これには テキストおよび HTML ヘッダーとフッター の追加が含まれます。 また、画像のスタンプページ番号 の追加、さらにはページのサイズとレイアウトのカスタマイズも可能です。 これらすべてのオプションは、この方法を使用して PDF を作成する場合に利用可能です。

RenderContentPageToPdfメソッドはデフォルトでは非同期で、Task<PdfDocumentを返します。 これは、複雑なレイアウトを扱うときや、複数のPDFを同時に生成するときに特に役立つ、ノンブロッキングPDF生成を可能にします。 このメソッドは、XAMLのビジュアル要素をPDFに変換し、色、フォント、レイアウト構造を保持します。

XAMLファイルでどのような変更が必要ですか?

MainPage.xamlファイルで、デフォルトのOnCounterClicked関数を新しいPrintToPdf関数に置き換えます。 このボタンをクリックすると、PrintToPdf メソッドが実行され、PDF が作成されます。 この簡単な修正は、最小限のコード変更で、あなたのMAUIアプリケーションをPDFジェネレータに変えます。

<Button
    x:Name="PrintToPdfBtn"
    Text="Print to pdf"
    SemanticProperties.Hint="Click to print page as PDF"
    Clicked="PrintToPdf"
    HorizontalOptions="Center" />
<Button
    x:Name="PrintToPdfBtn"
    Text="Print to pdf"
    SemanticProperties.Hint="Click to print page as PDF"
    Clicked="PrintToPdf"
    HorizontalOptions="Center" />
XML

ボタンは、標準的なMAUIスタイリングプロパティを使ってスタイリングすることができ、PDFが生成されている間、読み込みインジケータのような視覚的フィードバックを追加することができます。 これにより、PDF作成プロセスでのスムーズなユーザーエクスペリエンスが保証されます。

出力PDFはどのように見えますか?

PDFファイルを保存する前に、PdfDocumentで利用可能なメソッドを使って、さらに変更を加えることができます。 ページを結合、分割、または回転させることができます。 注釈を追加し、PDF にブックマークを追加することもできます。 さらに、著者、タイトル、キーワードなどのPDFメタデータを設定して、文書の構成と検索性を向上させることができます。

生成されるPDFは、フォント、色、レイアウトの制約など、MAUIページの視覚的な階層とスタイルを維持します。 そのため、アプリケーションの画面の印刷用バージョンを作成したり、アプリケーションのUIに基づいてレポートを作成したりするのに最適です。

完全なMAUIサンプルプロジェクトはどこからダウンロードできますか?

このガイドの完全なコードをダウンロードできます。これは.zipファイルとして提供され、Visual Studioで.NET MAUIアプリプロジェクトとして開くことができます。 サンプルプロジェクトは必要な依存関係をすべて含み、IronPDFをMAUIアプリケーションに統合するためのベストプラクティスを示しています。

サンプルプロジェクトはWindowsとmacOSの両方のデスクトッププラットフォームで動作するように設定されており、MAUIとIronPDFのクロスプラットフォーム機能を紹介しています。 さまざまなPDF生成シナリオの例が含まれており、さまざまなページレイアウトやコンテンツタイプの扱い方を示しています。

MAUI サンプル プロジェクトのフルバージョンをダウンロード

こちらのチュートリアル ページ"PDF の変換"で、さらに多くの可能性を探ります。 また、 PDF 圧縮に関するガイドを参照して、Web 配信用に生成された PDF を改善する方法や、Web ベースの PDF 生成シナリオ向けにBlazor Servers で PDF を作成する方法について学習することもできます。

よくある質問

.NET MAUIとは何か、PDF生成とどのように関係するのか。

.NET MAUI (Multi-platform App UI) はXamarin.Formsから拡張されたネイティブデバイスアプリケーションを構築するためのクロスプラットフォームフレームワークです。IronPdfは.NET MAUIアプリケーションと統合し、RenderContentPageToPdfメソッドを使用してXAMLページからPDF生成を可能にし、開発者がMAUIアプリケーションのUIをプロフェッショナルなPDFドキュメントに変換できるようにします。

MAUIアプリケーションでのPDF生成に対応しているプラットフォームは?

IronPDFは現在、デスクトップ(WindowsとmacOS)とウェブプラットフォームのMAUIアプリケーションでのPDF生成をサポートしています。モバイルプラットフォームは現在IronPDFによるMAUI PDF生成には対応していません。

MAUIでXAMLをPDFに変換するには、どの拡張パッケージが必要ですか?

メインのIronPdfパッケージとともにIronPdf.Extensions.Mauiパッケージが必要です。この拡張パッケージは特にMAUIのXAMLベースのUIフレームワークとIronPdfのPDF生成機能を橋渡しし、MAUIのContentPageオブジェクトをPDFとしてレンダリング可能なHTMLに変換します。

C#でMAUI XAMLページをPDFに変換するには?

IronPDFでMAUI XAMLページをPDFに変換するのは簡単です。たった1行のコードでRenderContentPageToPdfメソッドを使うことができます: var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf().SaveAs('page.pdf').これはIronPDFのChromeレンダリングエンジンを活用し、XAMLレイアウトをPDFフォーマットに正確に変換します。

MAUIアプリケーションにPDF生成を実装するための基本的なステップは何ですか?

基本的なワークフロー1) MAUI用IronPDF C#ライブラリのダウンロード、2) RenderContentPageToPdfメソッドを使用するためにMainPage.xaml.csファイルの修正、3) 関数をトリガーするためにMainPage.xamlのボタンの更新、4) PDFドキュメントのエクスポートまたはMAUIアプリでの表示、5) クイックスタートのためにIronPDFのサンプルMAUIプロジェクトのダウンロード。

PDF変換プロセスで使用するレンダリングエンジンは何ですか?

IronPdfはMAUIアプリケーションのPDF生成処理にChromeレンダリングエンジンを使用しています。これにより、MAUIアプリケーションのユーザーインターフェースの視覚的整合性を保ちながら、XAMLレイアウトを正確にPDF形式に変換することができます。

カーティス・チャウ
テクニカルライター

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

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

準備はできましたか?
Nuget ダウンロード 17,012,929 | バージョン: 2025.12 リリース