Comment convertir des vues Razor en PDF sans tête en C#

Pourquoi ai-je besoin de Razor.Templating.Core au lieu de IronPdf.Extensions.Razor?

Razor.Templating.Core offre un véritable rendu sans tête, convertissant les vues Razor en HTML sans contexte web ni fenêtre de navigateur. Ces outils conviennent aux services d'arrière-plan, aux applications de console ou aux environnements sans interface utilisateur. IronPdf.Extensions.Razor nécessite un contexte web pour fonctionner.

Quel type de projet convient le mieux à la génération de PDF sans tête?

Les projets ASP.NET Core Web App (modèle-vue-contrôleur) fournissent l'infrastructure Razor View nécessaire avec des options de déploiement flexibles. Utilisez cette approche dans les services d'arrière-plan, les fonctions Azure ou les applications de console. Voir déploiement d'IronPDF sur Azure pour une génération basée sur le cloud.

Comment installer les paquets NuGet requis?

Installez les paquets à l'aide du gestionnaire de paquets NuGet. Vous avez besoin d'IronPDF et de Razor.Templating.Core :

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

Quel contenu HTML dois-je ajouter à ma vue Razor?

Ajoutez le code HTML que vous souhaitez convertir en PDF :

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

Pour les mises en page complexes, utilisez CSS et les styles d'impression pour garantir un rendu parfait du PDF. IronPDF prend en charge les fonctionnalités modernes de CSS3 pour des mises en page de documents sophistiquées.

Pourquoi utiliser des tableaux pour l'affichage des données dans les PDF ?

Les tableaux fournissent des informations structurées et organisées qui se traduisent bien dans les documents imprimés. La mise en forme doit être cohérente d'une plateforme à l'autre et les traductions sont lisibles au format PDF. Le moteur de rendu d'IronPDF gère bien les mises en page de tableaux, en préservant les bordures, l'espacement et l'alignement. Pour une mise en forme avancée, explorez les marges personnalisées pour optimiser la mise en page.

Quelles sont les considérations stylistiques courantes pour les sorties PDF ?

Pour la sortie PDF, utilisez des requêtes média CSS spécifiques à l'impression, des valeurs de pixels fixes au lieu d'unités relatives, et des polices intégrées pour un rendu cohérent. IronPDF prend en charge les polices web et les polices d'icônes pour la cohérence de la marque. Pensez à sauts de page pour les documents de plusieurs pages et à des marges appropriées pour une apparence professionnelle.

Quelles sont les options de rendu que je peux appliquer à mes PDF ?

IronPDF propose des options de rendu étendues. Ajoutez des en-têtes et pieds de page, définissez des formats de papier personnalisés, contrôlez l'orientation de la page et ajoutez des marques d'eau. ChromePdfRenderer offre plus de 50 propriétés pour personnaliser la génération de PDF.

Comment gérer les erreurs lors de la génération d'un PDF?

Mise en œuvre de la gestion des erreurs pour une génération PDF robuste :

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

Quand devrais-je activer la journalisation détaillée?

Permettre une journalisation détaillée pendant le développement et le dépannage. La journalisation d'IronPDF fournit des indications sur le rendu, permettant d'identifier les problèmes d'analyse HTML, de chargement de ressources ou de configuration. Pour la production, utilisez custom logging pour vous intégrer à l'infrastructure de journalisation de votre application.

Quels sont les autres problèmes liés au chemin à suivre ?

Au-delà du problème du tilde (~), il faut s'assurer que les sources d'images utilisent des chemins d'accès absolus ou des références relatives appropriées. Pour les ressources externes, utilisez l'URL de base pour vous assurer que les actifs se chargent correctement. Pour les images d'Azure Blob Storage, voir embedding images from Azure Blob Storage.

Comment les ressources statiques affectent-elles la génération de PDF ?

Les actifs statiques (CSS, JavaScript, images) ont un impact sur les performances et la qualité de la génération de PDF. Veillez à ce que les ressources soient accessibles lors du rendu, utilisez des images optimisées et envisagez d'intégrer les feuilles de style CSS essentielles en ligne pour un rendu plus rapide. En savoir plus sur les délais de rendu et les timeouts pour les contenus à forte composante JavaScript.

Exécutez le projet pour générer un document PDF.

Sortie PDF

À quoi doit ressembler mon PDF final?

Votre PDF doit conserver l'intégralité de la mise en forme de Razor View : structures des tableaux, polices, couleurs et mise en page. Elle doit être correctement dimensionnée, avec des marges propres et une apparence professionnelle. Pour vérifier la qualité de la sortie, utilisez les fonctions de tramage d'IronPDF pour prévisualiser les pages en tant qu'images.

Comment résoudre les problèmes courants liés au rendu des PDF?

Les problèmes les plus courants sont les styles manquants, les mises en page défectueuses ou le contenu incomplet. Activez la journalisation détaillée, vérifiez les chemins d'accès aux ressources et veillez à ce que le code HTML soit correctement validé. Pour les mises en page complexes, utilisez les outils de débogage Chrome pour prévisualiser le HTML avant la conversion. Pour les problèmes de rendu spécifiques, utilisez Les délais d'attente pour vous assurer que le contenu se charge avant le rendu.

Quelles sont les conditions préalables à l'exécution de l'exemple de projet ?

Vous avez besoin de Visual Studio 2019 ou d'une version ultérieure avec .NET 6.0 SDK ou une version plus récente. Le projet nécessite une connexion internet pour la restauration des paquets NuGet. Mettez à jour votre clé de licence IronPDF dans Program.cs avant de l'exécuter. Pour le déploiement, consultez le guide d'installation de Windows pour connaître les exigences supplémentaires.

Comment adapter l'exemple à mon cas d'utilisation ?

L'exemple fournit une base pour vos besoins spécifiques. Ajoutez des modèles de données dynamiques, mettez en cache les PDF fréquemment générés ou intégrez l'authentification existante. Pour les scénarios avancés, explorez la génération de PDF asynchrones pour améliorer les performances, ou mettez en œuvre la compression de PDF pour réduire la taille des fichiers. Ajoutez des signatures numériques pour l'authenticité des documents ou des protection par mot de passe pour les documents sensibles.