IRONSOFTWAREHOME
VIDÉOS

Comment convertir XAML en PDF dans .NET MAUI

Curtis Chau
Curtis Chau
Updated: 19 juillet 2026

Pourquoi migrer de pdforge à IronPDF

Compréhension de pdforge

pdforge (rebaptisé en "pdf noodle" en 2026 — pdfnoodle.com; le nom d'hôte api.pdforge.com continue de fonctionner via des redirections 301 jusqu'à la fin de 2026) est une API de génération de PDF basée sur le cloud, axée sur les modèles, offrant un moyen simple de produire des fichiers PDF en intégrant avec votre application via des appels HTTP. Il n'y a pas de SDK .NET officiel sur NuGet — l'intégration se fait avec HttpClient contre les endpoints REST documentés. En confiant la création de PDF à une API externe, les développeurs peuvent simplifier le processus de développement. Cependant, pdforge présente des inconvénients tels que des dépendances externes, des options de personnalisation limitées et des coûts d'abonnement permanents dont les développeurs doivent être conscients.

Le problème de la dépendance de l'API Cloud

pdforge traite tous les documents sur des serveurs cloud externes. Cette architecture pose des problèmes importants pour les applications de production :

  1. Traitement sur serveur externe : Chaque PDF que vous générez nécessite l'envoi de vos données HTML aux serveurs de pdforge ; vos documents quittent votre infrastructure.

  2. Risques liés à la confidentialité et à la conformité : des données sensibles transitent par Internet vers des serveurs tiers. Lorsqu'ils utilisent pdforge, les développeurs doivent tenir compte des problèmes de sécurité liés à l'envoi de données à une API externe. Si le contenu du PDF contient des informations sensibles, cela peut constituer un facteur critique.

  3. Frais d'abonnement récurrents : Les frais mensuels s'accumulent indéfiniment sans transfert de propriété. Le modèle SaaS de pdforge engendre des dépenses opérationnelles continues susceptibles de s'accumuler au fil du temps.

  4. Dépendance à Internet : aucune génération de PDF lorsque le réseau est indisponible.

  5. Limites de débit : les plafonds d'utilisation des API peuvent limiter le volume des applications.

  6. Latence du réseau : le temps d'aller-retour ajoute des secondes à chaque génération de PDF.

Comparaison entre Pdforge et IronPDF

FonctionpdforgeIronPDF
Type de déploiementAPI basée sur le cloudBibliothèque locale
DépendancesNécessite une authentification Internet et APIAucune dépendance externe
PersonnalisationContrôle limité sur la génération de PDFContrôle total de la personnalisation
Structure des coûtsAbonnement en coursOption d'achat unique
SécuritéProblèmes potentiels liés aux données envoyées sur le webLe traitement des données se fait entièrement dans l'environnement local
Complexité de l'installationInstallation initiale plus facile grâce à la manipulation externeNécessite plus d'installation et de configuration initiales

IronPDF se différencie en fournissant une bibliothèque entièrement locale, accordant aux développeurs un contrôle total sur le processus de création de PDF. Ceci est particulièrement avantageux pour les applications où le traitement interne des fichiers est préféré, ou lorsque les appels d'API externes posent des problèmes de sécurité.IronPDF traite tout localement, ce qui minimise ces risques.

Pour les équipes planifiant l'adoption de .NET 10 et C# 14 sur les versions actuelles de .NET,IronPDF fournit une base de traitement locale qui élimine la dépendance au cloud tout en ajoutant des capacités complètes de manipulation de PDF.


Avant de commencer

Prérequis

  1. Environnement .NET : .NET Framework 4.6.2+ ou .NET Core 3.1+ / .NET 5/6/7/8/9+
  2. Accès à NuGet : possibilité d'installer des packages NuGet
  3. Licence IronPDF : Obtenez votre clé de licence sur IronPDF

Modifications du paquet NuGet

# pdforge has no official .NET SDK on NuGet — integration is HttpClient + JSON.
# If your project depends only on built-in System.Net.Http, there is no
# competitor package to remove. Just install IronPDF:
dotnet add package IronPdf
SHELL

Configuration de la licence

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

Identifier l'utilisation de pdforge

# Find pdforge / pdf noodle endpoint usage
grep -r "api\.pdforge\.com\|api\.pdfnoodle\.com" --include="*.cs" .

# Find API key / Bearer token references
grep -r "pdfnoodle_api_\|pdforge_api_" --include="*.cs" --include="*.json" --include="*.config" .

# Find Chromium header/footer templates that need migrating
grep -r "totalPages\|pageNumber\|footerTemplate\|headerTemplate" --include="*.cs" .
SHELL

Référence API complète

Modifications de l'espace de nommage

// Before: pdforge — raw HttpClient against api.pdfnoodle.com
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

Correspondances de concepts de base

pdforge (REST)IronPDF
HttpClient + Authorization: Bearer pdfnoodle_api_...new ChromePdfRenderer()
POST https://api.pdfnoodle.com/v1/html-to-pdf/syncrenderer.RenderHtmlAsPdf(html)
Corps JSON { html, pdfParams }ChromePdfRenderer + RenderingOptions
Réponse : un ensemble JSON avec signedUrlPdfDocument
Retour : byte[] (après avoir récupéré signedUrl)pdf.BinaryData

Mappages d'Opération

pdforgeIronPDF
POST /v1/html-to-pdf/sync avec { html }renderer.RenderHtmlAsPdf(html)
Récupérer l'URL, puis POST son HTML (aucun point de terminaison d'URL dédié)renderer.RenderUrlAsPdf(url)
Télécharger signedUrl puis File.WriteAllBytes(path, bytes)pdf.SaveAs(path)
await http.GetByteArrayAsync(signedUrl)pdf.BinaryData

Mappages de configuration

pdforge pdfParamsIronPDF(RenderingOptions)
format: "A4"renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
landscape: truerenderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
margin: { top: "20px" }renderer.RenderingOptions.MarginTop = 20
footerTemplate avec <span class="pageNumber"> / <span class="totalPages">TextFooter = new TextHeaderFooter { CenterText = "Page {page} of {total-pages}" }

Nouvelles fonctionnalités non disponibles dans pdforge

Fonctionnalité d'IronPDFDescription du projet
PdfDocument.Merge()Combiner plusieurs PDF
pdf.ExtractAllText()Extraction de texte à partir de PDF
pdf.ApplyWatermark()Ajouter des filigranes
pdf.SecuritySettingsProtection par mot de passe
pdf.FormRemplissage de formulaires
pdf.SignWithDigitalSignature()Signatures numériques

Exemples de migration de code

Exemple 1 : Conversion d'une chaîne HTML en fichier PDF

Avant (pdforge):

// REST API — no .NET SDK on NuGet. Integration is HttpClient + JSON POST.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var http = new HttpClient();
        http.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");

        var body = new { html = "<html><body><h1>Hello World</h1></body></html>" };
        var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");

        var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
        resp.EnsureSuccessStatusCode();

        using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
        var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

Après (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

La différence fondamentale réside dans le modèle de traitement et le type de retour. pdforge nécessite un POST HttpClient authentifié à https://api.pdfnoodle.com/v1/html-to-pdf/sync, qui renvoie un ensemble JSON contenant une URL S3 signée — vous récupérez ensuite les octets du PDF à partir de cette URL et les enregistrez avec File.WriteAllBytes().

IronPDF utilise ChromePdfRenderer avec RenderHtmlAsPdf() qui renvoie un objet PdfDocument. Cet objet peut être enregistré directement avec SaveAs(), ou vous pouvez accéder à pdf.BinaryData si vous avez besoin des octets bruts. Le PdfDocument permet également la manipulation (ajouter des filigranes, fusionner avec d'autres PDFs, ajouter de la sécurité) avant l'enregistrement. Consultez la documentation HTML vers PDF pour des exemples complets.

Exemple 2 : Conversion d'une URL en PDF

Avant (pdforge):

// REST API — no .NET SDK on NuGet. pdforge has no dedicated URL endpoint;
// fetch the page yourself and POST its HTML to /v1/html-to-pdf/sync.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var http = new HttpClient();
        http.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");

        var sourceHtml = await http.GetStringAsync("https://example.com");
        var body = new { html = sourceHtml };
        var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");

        var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
        resp.EnsureSuccessStatusCode();

        using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
        var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}

Après (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

pdforge n'a pas de point de terminaison URL-to-PDF dédié — vous récupérez la page vous-même, puis postez son HTML au point de terminaison synchrone et téléchargez le résultat depuis l'URL signée retournée.IronPDF utilise RenderUrlAsPdf() sur ChromePdfRenderer, renvoyant un PdfDocument avec la méthode intégrée SaveAs().

Le principal avantage d'IronPDF est que l'URL est récupérée et rendue localement à l'aide d'un moteur Chromium - aucune donnée n'est envoyée à des serveurs externes. IronPDF, étant une bibliothèque locale, peut offrir de meilleures performances car il n'y a pas de temps d'aller-retour impliqué dans les requêtes web. En savoir plus sur la conversion d'URL en PDF.

Exemple 3 : Fichier HTML vers PDF avec des paramètres personnalisés

Avant (pdforge):

// REST API — no .NET SDK on NuGet. Page size / orientation flow through the
// optional `pdfParams` object using Chromium/Puppeteer-style names.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var http = new HttpClient();
        http.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");

        var htmlContent = File.ReadAllText("input.html");
        var body = new { html = htmlContent, pdfParams = new { format = "A4", landscape = true } };
        var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");

        var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
        resp.EnsureSuccessStatusCode();

        using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
        var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

Après (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        var htmlContent = System.IO.File.ReadAllText("input.html");
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

Cet exemple illustre la différence entre les modèles de configuration. pdforge transmet des options comme des champs JSON à l'intérieur d'un objet pdfParams dans le corps du POST (format = "A4", landscape = true), suivant les conventions de nommage de Chromium/Puppeteer.

IronPDF utilise la propriété RenderingOptions avec des enums fortement typés : renderer.RenderingOptions.PaperSize = PdfPaperSize.A4 et renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape. Ces outils offrent une prise en charge IntelliSense et une sécurité de type au moment de la compilation. Notez que IronPDF nécessite l'importation du namespace IronPdf.Rendering pour les enums de taille et d'orientation du papier. Voir les tutoriels pour plus d'exemples de configuration.


Notes de migration essentielles

Changement de type de retour

pdforge retourne une enveloppe JSON avec une URL signée ;IronPDF renvoie PdfDocument :

// pdforge: Two-step — parse signedUrl from JSON, then fetch bytes from it
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);

// IronPDF: Returns PdfDocument
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");           // Direct save
byte[] bytes = pdf.BinaryData;      // Get bytes if needed

Changement de Générateur

// pdforge: HttpClient against the REST endpoint
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");

// IronPDF: ChromePdfRenderer
var renderer = new ChromePdfRenderer();

Changements d'Opération

// pdforge operations
await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);   // HTML to PDF
// URL to PDF: fetch the page first, then POST its HTML to the same endpoint

//IronPDF methods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)
C#

Enregistrer le changement de méthode

// pdforge: Two-step — fetch bytes from signed URL, then write to disk
var pdfBytes = await http.GetByteArrayAsync(signedUrl);
File.WriteAllBytes("output.pdf", pdfBytes);

// IronPDF: Built-in save method
pdf.SaveAs("output.pdf");

Modification de l'emplacement de la configuration

pdforge transmet les options comme des champs JSON sur pdfParams ;IronPDF utilise RenderingOptions :

// pdforge: JSON pdfParams object on the POST body
var body = new { html, pdfParams = new { format = "A4", landscape = true } };

// IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

Syntaxe de l'en-tête et du pied de page

pdforge hérite du format de modèle d'en-tête/pied de page de Chromium — fragments HTML contenant des éléments <span class="..."></span> que le moteur substitue au moment du rendu.IronPDF utilise des espaces réservés entre crochets à l'intérieur d'un TextHeaderFooter / HtmlHeaderFooter :

// pdforge: Chromium template HTML inside pdfParams.footerTemplate
// "<div>Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span></div>"

//IronPDF placeholders
"Page {page} of {total-pages}"  // Note: hyphen in total-pages
C#

Nouvelles capacités après la migration

Après avoir migré vers IronPDF, vous bénéficiez de fonctionnalités que pdforge ne peut pas vous offrir :

Fusion de fichiers PDF

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

Extraction de texte

var pdf = PdfDocument.FromFile("document.pdf");
string allText = pdf.ExtractAllText();

Marques de fond

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

Protection par mot de passe

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

Résumé de la comparaison des fonctionnalités

FonctionpdforgeIronPDF
HTML vers PDF
URL vers PDF
Paramètres de la page
Capacité hors ligne
Traitement local
Fusionner des PDF
Diviser les PDF
Extraire le texte
Filigranes
Remplissage de formulaires
Signatures numériques
Protection par mot de passe
Pas de limite de tarif
Licence unique

Liste de contrôle de la migration

Pré-migration

  • Inventorier tous les appels aux endpoints de pdforge / pdf noodle dans la base de code (api.pdforge.com, api.pdfnoodle.com)
  • Documenter la configuration JSON actuelle pdfParams utilisée (taille de page, orientation, marges)
  • Identifier les modèles d'en-tête/pied de page de style Chromium (<span class="pageNumber">, <span class="totalPages">) à convertir en espaces réservés d'IronPDF ({page}, {total-pages})
  • Planifier le stockage de la clé de licence IronPDF(variables d'environnement recommandées)
  • Commencez par tester avec une licence d'essai IronPDF.

Modifications du paquet

  • pdforge n'a pas de SDK .NET sur NuGet — il n'y a pas de package concurrent à supprimer
  • Installer le package NuGet IronPdf : dotnet add package IronPdf

Modifications du code

  • Supprimer les imports System.Net.Http / System.Text.Json utilisés uniquement pour les appels pdforge
  • Ajouter using IronPdf; et using IronPdf.Rendering; pour les enums de taille et d'orientation du papier
  • Remplacer le HttpClient authentifié par ChromePdfRenderer
  • Remplacer POST /v1/html-to-pdf/sync par RenderHtmlAsPdf()
  • Remplacer le modèle fetch-URL-then-POST par RenderUrlAsPdf()
  • Remplacer le modèle en deux étapes GetByteArrayAsync(signedUrl) + File.WriteAllBytes() par pdf.SaveAs()
  • Déplacer pdfParams.format vers RenderingOptions.PaperSize
  • Déplacer pdfParams.landscape vers RenderingOptions.PaperOrientation
  • Utiliser PdfPaperSize.A4 / PdfPaperOrientation.Landscape enums
  • Convertir les modèles Chromium en espaces réservés IronPDF à l'intérieur TextHeaderFooter / HtmlHeaderFooter
  • Remplacer le jeton par requête Bearer par un jeton unique IronPdf.License.LicenseKey au démarrage

Après la migration

  • Testez la qualité de la sortie PDF en fonction des attentes
  • Vérifier que le fonctionnement hors ligne fonctionne
  • Supprimer les identifiants API de la configuration
  • Ajouter de nouvelles fonctionnalités (fusion, filigranes, sécurité) selon les besoins

Veuillez noter: pdforge et pdf noodle sont des marques commerciales de leurs propriétaires respectifs. Ce site n'est pas affilié, approuvé ou parrainé par le propriétaire de pdforge / pdf noodle. Tous les noms de produits, logos et marques sont la propriété de leurs propriétaires respectifs. Les comparaisons sont à titre informatif uniquement et reflètent les informations publiquement disponibles au moment de l'écriture.
Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

...
Lire la suite

Articles connexes

Key in blue circle

Obtenez votre clé d'essai de 30 jours instantanément.

Your trial license will be sent to your email address

Aucune restriction. 100 % débloqué. Pas de carte bancaire.

bullet_checkedAucune carte de crédit ou création de compte requiseAucune restriction. 100 % débloqué. Pas de carte bancaire.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Réservez votre Démonstration en direct gratuite
Booking Badge

De confiance par des millions d'ingénieurs dans le monde entier

Logos des clients d'Iron Software
Obtenez Votre Consultation sans Engagement
Remplissez le formulaire ci-dessous ou envoyez un email à sales@ironsoftware.com
Vos informations seront toujours gardées confidentielles.
De confiance par des millions d'ingénieurs dans le monde entier
Logos des clients d'Iron Software
Obtenez votre clé d'essai 30 jours gratuitement.
Aucune carte de crédit ou création de compte requise