信息圖標
跳過到頁腳內容
  1. IronPDF
  2. IronPDF博客
  3. 使用 ironpdf
  4. Xamarin PDF生成器
使用IRONPDF

如何創建 Xamarin PDF 生成器

Curtis Chau
Curtis Chau
發表日期:

在 Xamarin.Forms 中創建 PDF 檔案可能會很棘手。 大多數 .NET PDF 庫不直接支持移動應用程序，並且嘗試在設備上直接生成 PDF 文件會導致錯誤或功能缺失。 這就是 IronPDF 的用武之地。 儘管它不以本地方式運行於 Xamarin 中，但您可以使用服務器端方法來創建 PDF 檔案，填寫 PDF 表單，處理多頁以及包含圖像、字體和自定義佈局，為您的移動應用提供豐富的 PDF 生成功能。

在此指南中，我們將向您展示如何使用 IronPDF 構建一個 Xamarin PDF 生成器，包括代碼示例、保存 PDF 文件的技巧以及使您的 PDF 看起來更專業的方法。

為什麼服務器端方法適用於 Xamarin PDF 生成

IronPDF 擅長從 HTML 內容創建 PDF 文件，完美支持 CSS、JavaScript 和高級佈局功能。 在服務器上運行它可以讓您的 Xamarin.Forms 應用程序發送 HTML 內容並接收完整呈現的 PDF 文件。 這樣的設置避免了移動設備的限制，同時讓用戶訪問專業的 PDF 生成，包括：

  • 可編輯字段的 PDF 表單
  • 帶有頁眉和頁腳的多頁
  • 圖像、字體和自定義佈局
  • 表格、圖形和數據的自動樣式

使用服務器端庫還可以減少應用程序的複雜性，避免因缺少字體或在 Android 和 iOS 之間渲染差異引起的錯誤。 此方法使您對文檔輸出擁有更多的控制權，並在不同的移動平台上保持一致的質量。

設置您的 PDF 生成 API

首先，創建一個承載 IronPDF 的 ASP.NET Core Web API 項目。 安裝 IronPDF NuGet 包：

Install-Package IronPdf

創建一個 PDF 控制器來處理生成請求：

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace PDFGenerationAPI.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost("generate")]
        public async Task<IActionResult> GeneratePdf([FromBody] PdfRequest request)
        {
            var renderer = new ChromePdfRenderer();
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
            renderer.RenderingOptions.MarginTop = 25;
            renderer.RenderingOptions.MarginBottom = 25;
            var pdf = await renderer.RenderHtmlAsPdfAsync(request.HtmlContent);
            return File(pdf.BinaryData, "application/pdf", "document.pdf");
        }
    }

    public class PdfRequest
    {
        public string HtmlContent { get; set; }
    }
}
using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace PDFGenerationAPI.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost("generate")]
        public async Task<IActionResult> GeneratePdf([FromBody] PdfRequest request)
        {
            var renderer = new ChromePdfRenderer();
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
            renderer.RenderingOptions.MarginTop = 25;
            renderer.RenderingOptions.MarginBottom = 25;
            var pdf = await renderer.RenderHtmlAsPdfAsync(request.HtmlContent);
            return File(pdf.BinaryData, "application/pdf", "document.pdf");
        }
    }

    public class PdfRequest
    {
        public string HtmlContent { get; set; }
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此控制器接受 HTML 內容並返回生成的 PDF。 ChromePdfRenderer 處理轉換，保持所有來自 HTML 的 CSS 樣式和 JavaScript 執行。 渲染選項允許自定義紙張尺寸、邊距、頁寬和其他 PDF 屬性。 您可以參考 API 文檔以獲取額外的配置方法。

輸出

如何創建一個 Xamarin PDF 生成器：圖 1 - PDF 生成 API 輸出

實現 Xamarin 客戶端

在您的 Xamarin.Forms 應用程序中，創建一個服務以與 API 通信。 此代碼示例演示客戶端的實現：

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

namespace XamarinFormsClient
{
    public class PdfService
    {
        private readonly HttpClient _httpClient;
        private const string ApiUrl = "https://your-api.com/api/pdf/generate"; // Replace with your API URL

        public PdfService()
        {
            _httpClient = new HttpClient();
        }

        public async Task<byte[]> GeneratePdfAsync(string htmlContent)
        {
            var request = new { HtmlContent = htmlContent };
            var json = JsonConvert.SerializeObject(request);
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var response = await _httpClient.PostAsync(ApiUrl, content);
            if (response.IsSuccessStatusCode)
                return await response.Content.ReadAsByteArrayAsync();
            throw new Exception("PDF generation failed");
        }
    }
}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

namespace XamarinFormsClient
{
    public class PdfService
    {
        private readonly HttpClient _httpClient;
        private const string ApiUrl = "https://your-api.com/api/pdf/generate"; // Replace with your API URL

        public PdfService()
        {
            _httpClient = new HttpClient();
        }

        public async Task<byte[]> GeneratePdfAsync(string htmlContent)
        {
            var request = new { HtmlContent = htmlContent };
            var json = JsonConvert.SerializeObject(request);
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var response = await _httpClient.PostAsync(ApiUrl, content);
            if (response.IsSuccessStatusCode)
                return await response.Content.ReadAsByteArrayAsync();
            throw new Exception("PDF generation failed");
        }
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此功能負責將 HTML 發送到服務器並接收作為字節數組的 PDF 文件。 使用 JSON 序列化保證客戶端與服務器之間的數據傳輸正確。 這些代碼片段提供了一個基礎，您可以用來擴展包括進度跟踪或錯誤處理等附加功能。

在移動設備上保存 PDF 文件

收到 PDF 後，使用特定平台的代碼來保存它。 實施適當的文件路徑處理和存儲權限控件：

public interface ISaveFile
{
    Task SavePdfAsync(string filename, byte[] pdfData);
}

// iOS Implementation
public class SaveFileIOS : ISaveFile
{
    public async Task SavePdfAsync(string filename, byte[] pdfData)
    {
        var documents = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        var filePath = Path.Combine(documents, filename);
        await File.WriteAllBytesAsync(filePath, pdfData);
        // Open PDF viewer
        await Launcher.OpenAsync(new OpenFileRequest
        {
            File = new ReadOnlyFile(filePath)
        });
    }
}
public interface ISaveFile
{
    Task SavePdfAsync(string filename, byte[] pdfData);
}

// iOS Implementation
public class SaveFileIOS : ISaveFile
{
    public async Task SavePdfAsync(string filename, byte[] pdfData)
    {
        var documents = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        var filePath = Path.Combine(documents, filename);
        await File.WriteAllBytesAsync(filePath, pdfData);
        // Open PDF viewer
        await Launcher.OpenAsync(new OpenFileRequest
        {
            File = new ReadOnlyFile(filePath)
        });
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此代碼示例展示了如何使用特定平台的 API 保存 PDF 和寫入文件。filePath 位置由系統確定，對於 Android，應實施適當的存儲權限來採用類似的邏輯。 通過這種方式處理文件，可以支持 PDF 表單、多頁和圖像，而無需額外的依賴項。 您可以將生成的文檔下載到設備的文檔中心以方便訪問。

輸出

如何創建一個 Xamarin PDF 生成器：圖 2 - Xamarin PDF 輸出

創建專業的 PDF 檔案

通過構建具有嵌入數據的 HTML 模板來生成專業的 PDF 文件。 此方法允許您創建具有結構化內容的 PDF 文檔，包括表格行和格式化的元素：

public string GenerateInvoiceHtml(Invoice invoice)
{
    return $@"
        <html>
        <head>
            <style>
                body {{ font-family: Arial; }}
                .header {{ background-color: #f0f0f0; padding: 20px; }}
                .invoice-details {{ margin: 20px 0; }}
                table {{ width: 100%; border-collapse: collapse; }}
                th, td {{ padding: 10px; border-bottom: 1px solid #ddd; }}
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>Invoice #{invoice.Number}</h1>
                <p>Date: {invoice.Date:yyyy-MM-dd}</p>
            </div>
            <div class='invoice-details'>
                <table>
                    <tr>
                        <th>Item</th>
                        <th>Quantity</th>
                        <th>Price</th>
                    </tr>
                    {string.Join("", invoice.Items.Select(i => 
                        $"<tr><td>{i.Name}</td><td>{i.Quantity}</td><td>${i.Price}</td></tr>"
                    ))}
                </table>
                <h3>Total: ${invoice.Total}</h3>
            </div>
        </body>
        </html>";
}
public string GenerateInvoiceHtml(Invoice invoice)
{
    return $@"
        <html>
        <head>
            <style>
                body {{ font-family: Arial; }}
                .header {{ background-color: #f0f0f0; padding: 20px; }}
                .invoice-details {{ margin: 20px 0; }}
                table {{ width: 100%; border-collapse: collapse; }}
                th, td {{ padding: 10px; border-bottom: 1px solid #ddd; }}
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>Invoice #{invoice.Number}</h1>
                <p>Date: {invoice.Date:yyyy-MM-dd}</p>
            </div>
            <div class='invoice-details'>
                <table>
                    <tr>
                        <th>Item</th>
                        <th>Quantity</th>
                        <th>Price</th>
                    </tr>
                    {string.Join("", invoice.Items.Select(i => 
                        $"<tr><td>{i.Name}</td><td>{i.Quantity}</td><td>${i.Price}</td></tr>"
                    ))}
                </table>
                <h3>Total: ${invoice.Total}</h3>
            </div>
        </body>
        </html>";
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此方法從您的數據模型中創建結構化 HTML，每一行代表一個發票項。 IronPDF 保留所有樣式，創建與您的品牌指南一致的專業文檔。 您還可以添加水印章、PNG 圖像和其他視覺元素來增強文檔的外觀。

常見問題與解決方案

在實施此架構時，您可能會遇到以下挑戰：

  • 網絡超時：為複雜的 PDF 文檔增加 HttpClient 超時
  • 大文件處理：流式傳輸超過 10MB 的 PDF 文件以避免內存問題
  • 離線場景：排隊 PDF 生成請求並設置未完成操作的存儲庫
  • 身份認證：使用 JWT 令牌和用戶權限控件保護端點
  • 速率限制：限制 API 請求以防止系統過載
  • 錯誤處理：在代碼中實施適當的錯誤消息和註釋以進行故障排除
  • 文件管理：在下載後處理文件刪除以管理存儲空間

在處理基於 XML 的數據或定義的架構時，確保在將內容發送到 API 之前進行正確的序列化。 為您的錯誤日誌添加鏈接以便於調試，並註冊事件處理程序以跟踪生成進度。

重要提示：Xamarin 支持終止

微軟宣布 Xamarin 的支持在 2024 年 5 月終止。對於新項目，考慮遷移到 .NET MAUI，該平台在多種編程語言中原生支持 IronPDF。 這消除了對服務器端 API 的需求，並啟用在移動設備上的直接 PDF 生成。

部署和許可考量

將您的 API 部署到 Azure App Service 或 AWS Lambda 等雲平台以實現可擴展性。 考慮以下因素：

  • IronPDF 許可：服務器部署需要適當的 IronPDF 許可證
  • 託管成本：計算 API 託管和帶寬開支
  • 性能：對於經常生成的 PDF 使用緩存以減少負載
  • 安全性：為所有端點實施 API 身份驗證和 HTTPS

結論

雖然 IronPDF 不直接支持 Xamarin，服務器端 API 方法為移動應用程序中的 PDF 生成提供了一個可靠的解決方案。 此架構利用 IronPDF 的強大渲染引擎，同時保持 iOS 和 Android 平台的跨平台兼容性。

準備好在您的 Xamarin 應用程序中實施 PDF 生成嗎？ 開始您的免費 IronPDF 試用並體驗專業的 PDF 創建能力。 對於生產環境的部署，探索我們的許可選項以找到適合您需求的解決方案。

常見問題解答

IronPDF 能否在 Xamarin.Forms 中原生使用？

IronPDF 無法在 Xamarin.Forms 中原生運行，但可以透過伺服器端方法集成，以處理 PDF 的建立和操作。

在行動應用中使用 IronPDF 產生 PDF 檔案有哪些好處？

使用 IronPDF，您可以建立 PDF 檔案、填寫表單、處理多頁、新增圖像、字體和自訂佈局，從而增強行動應用程式的 PDF 生成功能。

IronPDF 如何在 Xamarin 中建立 PDF 檔案？

IronPDF 使用伺服器端方法在 Xamarin 中產生 PDF，從而實現行動裝置通常不支援的複雜 PDF 功能。

是否可以使用 Xamarin 中的 IronPDF 來填寫 PDF 表單？

是的，IronPDF 支援填寫 PDF 表單，這是其針對 Xamarin 應用程式的全面 PDF 處理功能的一部分。

IronPDF 解決了 Xamarin PDF 生成的哪些挑戰？

IronPDF 透過使用伺服器端解決方案，解決了在行動裝置上直接產生 PDF 時遇到的錯誤和功能缺失等挑戰。

IronPDF 能否處理 Xamarin 應用程式中 PDF 的自訂佈局？

是的，IronPDF 可以在生成的 PDF 文件中包含自訂佈局，讓您可以控製文件的設計和呈現方式。

在 Xamarin 中使用 IronPDF 可以實現哪些 PDF 功能？

IronPDF 允許在 Xamarin 中實現多頁文件、表單填寫、圖像和字體整合以及自訂佈局等功能。

為什麼建議使用伺服器端方法在 Xamarin 和 IronPDF 中產生 PDF 檔案？

建議採用伺服器端方法，因為它可以繞過行動裝置的限制，確保可靠地建立 PDF 檔案並實現高級功能。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用