UTILISATION D'IRONPDF

Comment afficher un PDF à partir d'un tableau d'octets dans Blazor ?

Kannaopat Udonpant
Kannapat Udonpant
mai 8, 2023
Mise à jour mars 10, 2024
Partager:

1. Introduction

IronPDF pour solutions et documentation PDF C# est une bibliothèque PDF C# qui prend en charge le rendu des PDF et la conversion de tableaux d'octets en fichiers PDF. Il permet également de réviser et d'imprimer des PDF ; il permet également de réviser les PDF à l'aide d'outils d'annotation. L'ajout d'en-têtes et de pieds de page, ainsi que la fusion de plusieurs PDF sont également très pratiques avec IronPDF.

IronPDF peut être utilisé avec Blazor PDF viewer pour créer une visionneuse de PDF, et il peut gérer des fichiers de plus grande taille en créant un objet URL que le navigateur peut afficher.

En utilisant IronPDF avec Blazor, les développeurs peuvent créer une visionneuse PDF qui peut afficher des fichiers PDF à partir de tableaux d'octets ou d'un nom de fichier, et qui prend également en charge le téléchargement de fichiers. IronPDF fournit également une méthode pour gérer la pagination des documents PDF, qui fonctionne parfaitement avec Blazor.

De plus, IronPDF fournit des exemples de code pour convertir des tableaux d'octets en documents PDF, télécharger des fichiers PDF, et afficher des PDFs à partir d'une chaîne base64. Les développeurs peuvent également convertir des fichiers PDF en d'autres formats de fichier, comme transformer des images en documents PDF.

IronPDF peut être utilisé avec une application serveur Blazor et peut être intégré à Visual Studio pour offrir une expérience de développement transparente. Avec IronPDF, les développeurs peuvent créer un composant d'interface utilisateur de qualité professionnelle qui peut être utilisé pour créer des applications Web modernes et riches en fonctionnalités.

Cet article explique comment les développeurs peuvent utiliser IronPDF pour convertir des tableaux d'octets en documents PDF et les afficher dans un visualiseur PDF Blazor.

2. Exigences

Pour suivre le tutoriel, les outils et conditions suivants sont nécessaires :

  • Visual Studio 2019 ou une version ultérieure : Cette version est nécessaire pour créer et exécuter l'application Blazor. Il peut être téléchargé depuis le site officiel de Visual Studio
  • .NET 5.0 ou supérieur : Cette version est nécessaire pour construire et exécuter l'application Blazor. Il peut être téléchargé depuis la page officielle de téléchargement de .NET
  • IronPDF : Il s'agit de la bibliothèque d'interface utilisateur de qualité professionnelle qui sera utilisée pour convertir les tableaux d'octets PDF en un document PDF et l'afficher dans le visualiseur PDF de Blazor. Il peut être téléchargé depuis le site officiel d'IronPDF
  • Package NuGet IronPDF.Blazor : C'est le package NuGet qui sera utilisé pour intégrer IronPDF à l'application Blazor. Il peut être installé à partir du gestionnaire de paquets NuGet dans Visual Studio.

    Certaines fonctionnalités abordées dans le tutoriel peuvent nécessiter une version payante d'IronPDF. En outre, le tutoriel suppose une connaissance de base de Blazor et de C#.

3. Création d'une application Blazor

Nous devons créer un nouveau projet Visual Studio avant de pouvoir commencer à construire notre première application Blazor.

  • Ouvrez Visual Studio.
  • Cliquez sur Créer un nouveau projet.
  • Le modèle d'application du serveur Blazor doit être choisi.

    Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 1 : Création d'un nouveau projet dans Visual Studio

    Créer un nouveau projet dans Visual Studio

  • Sélectionnez l'option Suivant.
  • Le nom de votre application.

    Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 2 : Création d'un nouveau projet dans Visual Studio

    Créer un nouveau projet dans Visual Studio

  • Sélectionnez l'option Suivant.
  • Sélectionner un Framework .NET

    Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 3 : Choisir le Framework .NET 6.0 pour la nouvelle application Blazor Server

    Choisir le framework .NET 6.0 pour la nouvelle application Blazor Server

  • Cliquez sur le bouton Créer.
  • Comme indiqué ci-dessous, un nouveau projet sera créé.

    Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 4 : Qu'est-ce que Blazor et comment ça fonctionne

    Qu'est-ce que Blazor et comment ça fonctionne

    Afin de vous offrir un logiciel Blazor simple et prêt à l'emploi, plusieurs fichiers ont été produits.

  • Le point d'entrée pour l'application qui lance le serveur est program.cs, où vous configurez également le middleware et les services pour l'application.
  • La partie principale de l'application est appelée "App.razor".
  • Des exemples de pages web pour l'application sont disponibles dans le répertoire Pages.
  • Différents paramètres de profil pour l'environnement de développement local sont définis dans le fichier "launchSettings.json" situé dans le répertoire Properties. Lorsqu'un projet est créé, un numéro de port est automatiquement attribué et enregistré dans ce fichier.

    Démarrer le programme du modèle.

Types de projets Blazor

Blazor supporte deux types de projets : Blazor Server et Blazor WebAssembly.

Le premier type fonctionne sur le serveur et utilise SignalR pour communiquer avec le navigateur. Cela signifie que l'interface utilisateur de l'application est rendue sur le serveur et que le navigateur ne reçoit que les mises à jour du serveur. Blazor Server a l'avantage de pouvoir prendre en charge des applications plus importantes et peut facilement gérer un plus grand nombre d'utilisateurs.

Les applications Blazor WebAssembly, en revanche, s'exécutent entièrement dans le navigateur et ne nécessitent pas de serveur pour fonctionner. Ils sont donc plus légers et plus rapides à charger, mais ils présentent quelques limites, comme l'impossibilité de prendre en charge des fichiers plus volumineux.

Pour ce tutoriel, il est recommandé d'utiliser une application Blazor Server car elle permet d'afficher et de gérer des fichiers PDF, qui peuvent être plus volumineux. En outre, Blazor Server peut prendre en charge la révision et l'impression de PDF, ce qui peut être une fonction utile pour une application de visualisation de PDF.

Installation d'IronPDF

Dans cette section, nous verrons comment installer IronPDF en utilisant différentes méthodes

Utilisation de la ligne de commande

Accédez à Outils > Gestionnaire de packages NuGet > Console du gestionnaire de packages dans Visual Studio.

Saisissez la ligne suivante dans l'onglet terminal du gestionnaire de paquets :

Install-Package IronPdf

Maintenant que le paquet a été téléchargé, il sera installé dans le projet en cours.

Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 5 : Interface utilisateur de la console du gestionnaire de packages

Interface Console du Gestionnaire de Paquets

Utilisation de la gestion des paquets NuGet pour les solutions

L'interface utilisateur du gestionnaire de paquets NuGet est disponible dans Visual Studio pour installer le paquet directement dans le projet. La capture d'écran ci-dessous montre comment l'ouvrir.

Comment afficher un PDF à partir d'un tableau de bytes dans Blazor, Figure 6 : Accéder au gestionnaire de packages NuGet

Accédez au gestionnaire de packages NuGet

L'interface utilisateur du Gestionnaire de paquets propose une fonction Parcourir qui affiche une liste des bibliothèques de paquets proposées sur le site Web de NuGet. Saisissez le mot-clé "IronPDF", comme dans la capture d'écran ci-dessous, pour trouver le package IronPDF.

Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 7 : Recherchez et installez le package IronPDF dans l'interface utilisateur du gestionnaire de packages NuGet

Recherchez et installez le paquet IronPDF dans l'interface utilisateur de NuGet Package Manager

Localisez la bibliothèque IronPDF dans le gestionnaire de packages NuGet en la recherchant dans la section Parcourir.

Sélectionnez le paquet IronPDF et cliquez sur le bouton "Installer" pour l'ajouter au projet.

4. Création et affichage de PDF à partir d'un tableau d'octets

Pour générer des tableaux d'octets PDF en utilisant IronPDF dans une application Blazor, vous devez d'abord ajouter la dépendance IronPDF à votre projet.

Une fois que vous avez ajouté la dépendance IronPDF à votre application Blazor, vous pouvez créer un document PDF en utilisant le code suivant :

string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}
string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}
Private _url As String = ""
Private Async Function ViewFile() As Task
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
	_url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}"
End Function
$vbLabelText   $csharpLabel

Le fragment de code mentionné ci-dessus utilise d'abord la méthode RenderUrlAsPdf Method Documentation d'IronPDF, qui télécharge le texte HTML à partir d'une URL spécifiée et le convertit en format PDF. Le document PDF résultant est alors rendu sous la forme d'une chaîne de données base64 non traitées par l'extrait de code et enregistré dans une variable locale.

Les applications peuvent enregistrer les fichiers PDF créés sur le système de fichiers du serveur pour un accès ultérieur en utilisant la documentation de la fonction SaveAs d'IronPDF (accessible sur chaque documentation de l'instance ChromePdfRenderer).

Les données PDF base64 sont préparées pour être affichées sur le navigateur du client dans la section suivante du code.

@if (_url != string.Empty)
{

}
@if (_url != string.Empty)
{

}
'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: if(_url != string.Empty)
Private Sub New(Optional _url (Not ByVal) As = String.Empty)

End Sub
$vbLabelText   $csharpLabel

La fonction susmentionnée lie les données en base64 à l'attribut src d'un élément iframe après les avoir reçues du serveur Blazor côté serveur. Cela oblige les navigateurs à utiliser leurs visionneuses Web intégrées pour afficher le contenu Base64 sous forme de document PDF approprié dès le chargement de la page.

Voici une image d'un fichier PDF généré à partir d'une chaîne base64.

Comment afficher un PDF à partir d'un tableau d'octets dans Blazor, Figure 8 : Visualisation d'un PDF généré dans une application Blazor dans le navigateur

Visualisation d'un PDF généré dans une application Blazor dans le navigateur

Création de fichiers PDF simples

Voici un exemple d'extrait de code pour la création d'un document PDF simple à l'aide d'IronPDF en C# :

var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'var renderer = New IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
$vbLabelText   $csharpLabel

En utilisant la méthode décrite dans la section précédente, le navigateur d'un client peut être utilisé pour visualiser le document PDF créé.

6. Conclusion

Le tutoriel montre comment utiliser les capacités et tutoriels de IronPDF pour créer et afficher des documents PDF dans une application Blazor Server. Il commence par présenter IronPDF et ses capacités, y compris comment convertir du HTML en PDF, l'ajout de en-têtes et pieds de page personnalisés, et la fusion de plusieurs PDF. Il fournit ensuite des instructions pas à pas pour installer IronPDF, créer un fichier PDF dans une application Blazor Server, puis le convertir en un tableau d'octets PDF et l'afficher dans la visionneuse Blazor PDF à l'aide d'une iframe.

Dans l'ensemble, ce tutoriel fournit une vue d'ensemble complète de la manière de travailler avec IronPDF et Blazor pour créer et afficher des documents PDF. Il encourage les lecteurs à expérimenter davantage avec IronPDF et à essayer différentes fonctionnalités pour créer des applications riches en fonctionnalités.

Si vous êtes intéressé à essayer IronPDF dans votre projet Blazor, vous pouvez profiter de l'essai gratuit de IronPDF. Vous aurez ainsi tout le loisir d'expérimenter les caractéristiques et les fonctionnalités de la bibliothèque et de voir si elle répond à vos besoins.

Pour commencer, vous pouvez vous référer à la documentation IronPDF pour Blazor, qui fournit des informations détaillées sur l'utilisation de la bibliothèque dans votre projet. Vous pouvez également parcourir le Blog et Tutoriels IronPDF pour des tutoriels et des articles couvrant une gamme de sujets liés à la manipulation et au rendu des PDF.

Nous vous encourageons à prendre le temps d'expérimenter IronPDF et Blazor plus avant et de voir comment ils peuvent améliorer vos efforts de développement dans le domaine du PDF. Pour plus d'informations sur le visualiseur PDF Blazor, veuillez consulter le Tutoriel IronPDF Blazor PDF Viewer.

Kannaopat Udonpant
Ingénieur logiciel
Avant de devenir ingénieur logiciel, Kannapat a obtenu un doctorat en ressources environnementales à l'université d'Hokkaido au Japon. Tout en poursuivant ses études, Kannapat est également devenu membre du Vehicle Robotics Laboratory, qui fait partie du Department of Bioproduction Engineering (département d'ingénierie de la bioproduction). En 2022, il a mis à profit ses compétences en C# pour rejoindre l'équipe d'ingénieurs d'Iron Software, où il se concentre sur IronPDF. Kannapat apprécie son travail car il apprend directement auprès du développeur qui écrit la majeure partie du code utilisé dans IronPDF. Outre l'apprentissage par les pairs, Kannapat apprécie l'aspect social du travail chez Iron Software. Lorsqu'il n'écrit pas de code ou de documentation, Kannapat peut généralement être trouvé en train de jouer sur sa PS5 ou de revoir The Last of Us.
< PRÉCÉDENT
Comment enregistrer un fichier PDF en C# (Tutoriel pour débutants)
SUIVANT >
Comment désécuriser un PDF (Tutoriel pour débutants)