Utiliser IronPrint avec les assistants de codage IA

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

IronPrint est la bibliothèque d'impression .NET de Iron Software. Elle envoie des fichiers PDF et des images depuis le code C# vers une imprimante, soit silencieusement soit via la boîte de dialogue d'impression du système, sous Windows, macOS, iOS, et Android.

L'impression est la dernière étape de nombreuses fonctionnalités de document, et une étape difficile à tester, car sa sortie quitte la machine. Sans la documentation d'IronPrint, un assistant ne peut pas dire quel membre existe. Fournissez la documentation avant la première requête.

Chaque assistant a besoin des mêmes quatre étapes. Ajoutez le package, lisez la clé depuis l'environnement, fournissez à l'assistant la documentation lisible par machine d'IronPrint, et inspectez ce que chaque tâche contient avant de clore la tâche. Les mêmes étapes couvrent l'impression silencieuse, la sélection d'une imprimante par nom, les paramètres d'impression, et l'impression via dialogue.

Logo de l'assistant de codage Claude Code AILogo de l'assistant de codage ChatGPT Codex AILogo de l'assistant de codage AI GitHub CopilotLogo de l'éditeur de code AI CursorLogo de l'agent de codage AI Google Antigravity

Mon assistant IA ne peut-il pas gérer l'impression tout seul ?

Le guide d'impression silencieuse décrit le chemin System.Drawing.Printing comme un PrintDocument avec un gestionnaire d'événements de page pour chaque type de document et sans rendu PDF intégré.

L'API d'IronPrint se concentre sur deux classes, Printer et PrintSettings, et l'étape 3 liste la documentation lisible par machine qui les décrit.

Trois points s'appliquent avant qu'un assistant n'écrive le premier appel d'impression.

  • Le code d'impression improvisé coûte des jetons : chaque tentative de recréer un paramètre manquant à partir d'appels bruts System.Drawing.Printing dépense des jetons, et ce code lance une TypeInitializationException sous macOS.
  • Le nom du package est important : le package NuGet et le namespace sont tous deux IronPrint. Slopsquatting est l'enregistrement de noms de package que les modèles de langage produisent pour des packages inexistants, donc la demande doit nommer le package exactement.
  • La licence n'a pas de frais récurrents : les licences IronPrint sont perpétuelles. Chaque niveau sur la page de licences définit sa propre allocation de développeur, d'emplacement, et de projet.

Étape 1 : Installer IronPrint

Demandez à l'assistant d'ajouter le package et de nommer la version qu'il a résolue.

Add IronPrint version 2026.10.1 from NuGet to this project and restore packages.
Then tell me which IronPrint version the restore resolved.
Text

La commande .NET CLI épingle la même version.

dotnet add package IronPrint --version 2026.10.1
SHELL

Le framework cible détermine quel chemin d'impression le package utilise. Une construction net9.0-windows charge le chemin d'impression WPF d'IronPrint, et une construction net9.0 sous Windows charge un chemin basé sur System.Drawing.Printing. Les deux chemins rapportent différents noms de plateau pour la même imprimante. Pour Adobe PDF, le chemin WPF a renvoyé AutoSelect, tandis que la construction simple a renvoyé Automatically Select et OnlyOne. macOS nécessite la cible net9.0-macos ou net9.0-maccatalyst avec la charge de travail correspondante, et Linux n'est pas une plateforme d'impression supportée.


Étape 2 : Appliquez votre clé de licence

Sans clé, un programme peut encore lister les imprimantes et leurs plateaux, mais PrintAsync lance une IronSoftware.Exceptions.LicensingException avec le message Licence de Production Requise avant qu'une tâche ne soit créée. Print lance la même exception enveloppée dans System.AggregateException. Avec une clé invalide, le message est Clé de Licence Non Reconnue. Un programme non licencié ne produit donc aucune sortie, marquée ou autre. Le formulaire ci-dessous délivre une clé d'essai gratuite.

Commencez à utiliser IronPrint dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
arrow pointer

Définissez la clé une fois lorsque l'application démarre, avant le premier appel IronPrint. La clé vient d'une variable d'environnement, donc aucun commit ne la contient.

IronPrint.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPRINT_LICENSE_KEY");
C#

Une fois qu'une clé valide est assignée, IronPrint.License.IsLicensed renvoie true. IronPrint.License.IsValidLicense teste toute chaîne de clé. La bibliothèque ne lit jamais IRONPRINT_LICENSE_KEY d'elle-même, et dans le test de cet article, le fait de définir la variable sans l'assignation a laissé IsLicensed faux.

Veuillez noter: IronPrint License Keys couvre également le réglage de la clé dans Web.config, App.config, ou appsettings.json.

Étape 3 : Dirigez votre assistant vers la documentation LLM d'IronPrint

  • llms.txt indexe 43 pages, une ligne chacune. Incluez-le dans chaque nouvelle session.
  • llms-full.txt contient un résumé de chacune des 33 pages de documentation dans un seul fichier.
  • llms-full-catalog.txt est l'index avec les articles de blog inclus.
  • La référence des objets donne la signature de chaque membre.
  • Les outils qui lisent des fichiers de compétences peuvent charger skill.md. Ses sections couvrent l'installation, la licence, les recettes d'impression, le déploiement de plateforme, et les correctifs pour les échecs connus.
  • La feuille de spécification des produits IA liste les plateformes supportées et les principaux cas d'utilisation.

Si une tâche dépend d'un guide spécifique, dirigez l'assistant vers cette page.

Envoyez l'index avec une instruction de rester à l'intérieur.

Read https://ironsoftware.com/print/csharp/llms.txt first, before writing any IronPrint code.
Work only from what those pages document.

IronPrint's API is small, and it fits together like this:
- Printer is static, with Print, PrintAsync, ShowPrintDialog, GetPrinterNames, and GetPrinterTrays.
- PrintSettings holds the printer name, PaperSize, PaperOrientation, PaperMargins, Dpi, and copies.
- It also has the grayscale switch.
- There's no document object to build. You pass a file path or the file's bytes.

Look up any member those pages don't show.
The API reference is https://ironsoftware.com/print/csharp/object-reference/api/.
Compile once to confirm the call exists.
If it's still doubtful, tell me instead of guessing.
Then check this project's IronPrint calls against the docs and list any they don't cover.
Text

La ligne sur les membres douteux permet à l'assistant de signaler un manque au lieu d'inventer un membre.


Étape 4 : Ajoutez le contexte d'IronPrint à votre projet

Les instructions de chat se terminent avec la session, donc les règles d'IronPrint vont dans un fichier de projet que l'outil lit à chaque fois. Claude Code charge CLAUDE.md, ChatGPT Codex charge AGENTS.md, et le fichier GitHub Copilot est .github/copilot-instructions.md. Cursor charge les règles .mdc depuis .cursor/rules/ainsi que AGENTS.md, et Google Antigravity charge AGENTS.md ou GEMINI.md. Le même texte fonctionne dans chaque fichier, avec des métadonnées MDC ajoutées pour une règle Cursor. Commencez par ce bloc.

All printing in this project goes through IronPrint.
`IronPrint` is the name of both the NuGet package and the namespace.

Follow these rules in all printing code:
- Read the documentation index first at https://ironsoftware.com/print/csharp/llms.txt.
- Tools that accept skill files load https://ironsoftware.com/print/csharp/skill.md.
- Target an OS framework such as `net9.0-windows`, not plain `net9.0`.
- Set `IronPrint.License.LicenseKey` from IRONPRINT_LICENSE_KEY at startup.
- The key never goes to output, logs, or source control.
- Take printer names from `Printer.GetPrinterNames` and match them exactly.
- Refuse any other name. IronPrint sends an unknown name's job to the default printer.
- Use `Printer.PrintAsync` in UI code. `Printer.Print` blocks the thread that calls it.
- Print PDF, PNG, JPG, BMP, or TIFF. GIF and HTML files throw an unsupported file type error.
- Leave `PaperOrientation` on `Automatic` for mixed pages.
- `Portrait` shrinks a landscape page onto a portrait sheet.
- Read tray names in the build that prints. They differ between framework targets.
- Do not add a second printing library. If IronPrint cannot do something, say so.
Markdown

L'exemple de fichier unique du fichier de compétences fixe toujours IronPrint 2026.8.1, deux versions plus anciennes que le package 2026.10.1 testé ici.


Étape 5 : Invite de configuration en une seule fois

Cette invite combine les étapes 1 à 4 en un seul message, envoyé lorsque commence un projet ou une session.

Get this project ready for printing with IronPrint, under these rules:
- Reference the IronPrint NuGet package at version 2026.10.1.
- Target net9.0-windows or another OS-specific framework, not plain net9.0.
- Assign IronPrint.License.LicenseKey from the IRONPRINT_LICENSE_KEY environment variable.
- Do that at startup, before any other IronPrint call.
- Keep the key out of the console, the logs, and anything committed.
- Read https://ironsoftware.com/print/csharp/llms.txt before coding, and stay within it.
- For members it doesn't cover, search https://ironsoftware.com/print/csharp/object-reference/api/.
- Build before you rely on a member you found there.
- Where the tool takes skill files, load https://ironsoftware.com/print/csharp/skill.md.
- Trust the compiler over the skill file when they disagree.
- Only pass a printer name that Printer.GetPrinterNames returned.

Save these rules in the instructions file that later sessions read.
Then name the file you wrote, and any other change you made.
Text
Conseils: Ensuite, vérifiez le fichier de projet de l'étape 4 pour confirmer que les règles ont été écrites.

Étape 6 : Modèles d'invite qui produisent un code fonctionnel

Dites d'où vient le nom de l'imprimante, quel type de fichier s'imprime, et chaque paramètre d'impression.

Vague Imprimez la facture avec IronPrint.

Mieux Prenez le nom de l'imprimante depuis la configuration, confirmez qu'il apparaît dans Printer.GetPrinterNames, et imprimez invoice.pdf avec PrintSettings défini en A4, orientation automatique, en niveaux de gris, et deux copies.

Nommez la version IronPrint et le framework cible pour lequel le code est destiné.

Mieux Utilisez IronPrint 2026.10.1 sur net9.0-windows, et assignez la clé depuis IronPrint_LICENSE_KEY avant la première tâche.

Demandez des fichiers complets. Un fragment peut laisser de côté la directive using IronPrint; et la ligne qui assigne la clé.

Mieux Retournez l'ensemble de Program.cs avec chaque directive using et l'assignation de la licence, de sorte qu'il se construit sans modifications.


Étape 7 : Vérifiez ce que vous obtenez

Les sondes avec 2026.10.1 ont mesuré le comportement derrière chaque erreur ci-dessous.

  • Noms d'imprimante non vérifiés : un nom qui ne correspond à aucune imprimante installée ne soulève aucune erreur. Dans notre test, PrintAsync n'a pas soulevé d'exception, et la tâche est allée à l'imprimante par défaut, Microsoft Print to PDF, qui l'a gardée jusqu'à ce qu'une personne réponde à sa boîte de dialogue Enregistrer sous. Acceptez uniquement les noms que Printer.GetPrinterNames a renvoyés.
  • Print sur un thread de l'UI : l'appel synchrone bloque le thread qui l'appelle, ce qui fige les interfaces WPF et WinForms, comme l'explique la page de dépannage des blocages. Utilisez PrintAsync.
  • Une imprimante de test qui demande : deux tâches envoyées à Microsoft Print to PDF ne se sont terminées que lorsqu'une personne a tapé un nom de fichier. Un test non surveillé nécessite une imprimante qui termine seule, ou la méthode de capture dans la section suivante.
  • ShowPrintDialog sur une cible simple : la page de dépannage indique que l'appel peut lancer une AggregateException sur une cible .NET simple. Sous Windows, une construction net9.0 n'a pas lancé d'exception. L'appel a ouvert une vraie boîte de dialogue d'impression et n'est revenu que lorsque la boîte de dialogue a été fermée, après 10,1 secondes. Gardez les appels de dialogue en dehors du code non surveillé.

Laissez l'agent vérifier son propre travail

Demandez à l'assistant d'exécuter ces vérifications et de rapporter les preuves.

Rebuild in Release and run the app again.
If it has a capture or dry-run mode, use that and send nothing to a real printer.

When it finishes, give me proof:
- List every IronPrint type and member in the code, each with the docs page that covers it.
- Give the value of IronPrint.License.IsLicensed.
- Show where the printer name is checked against Printer.GetPrinterNames.
- For each document, give the printer, the settings sent, and the result.

Say whether the settings each job carried match the settings the code asked for.
Text

Travaux d'impression silencieuse avec IronPrint

Sous Windows, IronPrint 2026.10.1 passe chaque tâche à la classe de boîte de dialogue d'impression WPF sans la montrer, avec un ticket d'impression qui contient les paramètres. Un correctif de test a intercepté cet appel et sauvegardé chaque tâche en tant que fichier XPS, donc les valeurs ci-dessous ont été mesurées sans papier.

  • Chaque page PDF est rendue comme une image au réglage Dpi. Une page A4 est devenue une image 1240 par 1753 pixels à 150 DPI dans le test ci-dessous, et une image 2479 par 3508 pixels à 300 DPI dans notre sonde.
  • PaperSize.A4 a produit des pages 210 par 297 mm, et PaperSize.Letter a produit des pages 215,9 par 279,4 mm.
  • Avec PaperOrientation.Automatic, une page paysage a été imprimée comme une page paysage. Avec Portrait, la même page a été rétrécie pour s'adapter à une feuille portrait et n'a rempli que sa partie supérieure.
  • Une page PDF couleur est arrivée en tant qu'image grise lorsque Grayscale était activé. Le texte rouge dans un PNG est resté rouge, et seul le ticket d'impression demandait une sortie monochrome pour celui-ci.
  • NumberOfCopies a défini le nombre de copies du ticket, et la tâche contenait toujours un jeu de pages.

Le guide des paramètres d'impression indique que l'imprimante peut limiter le DPI et que certaines plateformes ignorent le nombre de copies, donc les deux valeurs sont des requêtes au pilote.


Formats de fichiers avec IronPrint

En 2026.10.1, les fichiers PDF, PNG, JPG, BMP, et TIFF s'impriment. Les fichiers GIF et HTML lancent une System.IO.InvalidDataException avec le message Type de fichier non supporté avant qu'une tâche ne soit créée, bien que le guide d'impression silencieuse liste les deux formats. Le fichier de compétences liste les cinq formats qui fonctionnent. Rendez d'abord le HTML en PDF, par exemple avec IronPDF.

Une image s'imprime comme une seule page, mise à l'échelle à la largeur de la page. Un PNG de 1200 par 800 pixels a été imprimé sur une page paysage A4 avec l'orientation Automatic, et sur la partie supérieure d'une page portrait avec Portrait.


Un résultat que vous pouvez reproduire

Le test est une seule invite, et tout le code vient de l'assistant. Créez un dossier vide, ouvrez une nouvelle session dedans, collez l'invite, et vérifiez le résultat par rapport à la liste sous Ce qui passe.

Veuillez noter: Les exigences sont Windows, le SDK .NET 9, un assistant qui exécute des commandes de terminal, un accès au réseau pour NuGet et la documentation, une clé d'essai ou de production IronPrint dans IRONPRINT_LICENSE_KEY, et le nom d'une imprimante installée dans PRINTER_NAME. L'invite capture chaque tâche dans un fichier XPS, donc cette imprimante ne reçoit rien.

L'invite

Comme l'application écrit son propre jeu de tests, les six fichiers du test sont joints ci-dessous dans l'ordre d'impression. Ses quatre fichiers PDF sont inchangés, et le PNG et le GIF apparaissent chacun sur une page de leur propre taille de pixel.

Build a .NET 9 Windows console app that silently prints a batch of documents with IronPrint.
Start in an empty directory and keep deliverables there.
If it holds a project or source files, tell me and stop.
Work alone and note each choice you make.

Work in this order:
1. Pin IronPrint at 2026.10.1 from NuGet and target net9.0-windows with WPF on, for step 4.
2. Read https://ironsoftware.com/print/csharp/llms.txt, mainly its silent printing guide.
3. Follow these code rules:
- Call only IronPrint members that the linked pages document.
- At startup, assign IRONPRINT_LICENSE_KEY to IronPrint.License.LicenseKey. You never need the key.
- Never show the key, list environment variables, or write the key to any file.
- When IronPrint.License.IsLicensed is false, report it and stop.
- Check PRINTER_NAME against Printer.GetPrinterNames before the first job.
- If the list lacks it, stop with a clear message and print nothing.
- Pass IronPrint only printer names from that list.
- Record its trays from Printer.GetPrinterTrays.
4. Send no job to a real print queue. Capture each one to XPS instead:
- IronPrint hands each Windows job to WPF's PrintDialog.PrintDocument.
- Patch it with Lib.Harmony 2.3.6 so your code runs instead.
- Save the paginator and PrintTicket to capture/<name of the file being printed>.xps.
- Note the queue and ticket settings.
- Before the first job, prove the patch with a null paginator that sends nothing.
- That self-test writes no file. Stop if it fails.
- Never clear capture/ at startup.
5. Generate testset/ with your own code and no added package:
- invoice-01.pdf and invoice-02.pdf, one A4 portrait page each.
- report-03.pdf, three A4 portrait pages, and chart-04.pdf, one A4 landscape page.
- label-05.png, 1200 by 800 pixels, and cover-06.gif, 600 by 400 pixels.
- Each page shows its file name and page number in large text.
6. Print them in that order with one PrintSettings object:
- A4, automatic orientation, one copy, grayscale and 150 DPI.
- Send each job with Printer.PrintAsync and time it.
- Record a failed job and move on.
7. Run a Release build with the given PRINTER_NAME.
8. Rerun with PRINTER_NAME set to No Such Printer 12345, then set it back.
9. That rerun must stop before any job and leave capture/ unchanged.
10. Write runrecord.md from measured values, one row per test file, with these columns:
- File, source pages counted from the file, and elapsed milliseconds.
- Result, either captured or the exception type and message.
- XPS pages read back from the file, each with width and height in millimeters and orientation.
- The ticket's queue, copy count, page size, orientation, color and resolution.
11. Below the table, give these values:
- IsLicensed, the self-test result and the printer's trays.
- Where the code stops if IsLicensed is false, without touching the key.
- What the No Such Printer 12345 run printed, and whether capture/ changed.
12. Tell me the build result, jobs captured out of six, cover-06.gif's outcome and your assumptions.
Text

Sortie

La fiche de course non modifiée de l'exécution fournit les valeurs mesurées pour chacun des six fichiers.

Chaque page que la capture a écrite se trouve dans le PDF ci-dessous, dans l'ordre d'impression.

La sortie par lots telle qu'IronPrint a construit les tâches, capturée en fichiers XPS à la place d'une imprimante et convertie en page PDF par page sans modifications.

  • La construction de Publication net9.0-windows a signalé 0 avertissements et 0 erreurs.
  • L'auto-test du correctif a réussi avec un pagineur nul et n'a écrit aucun fichier.
  • Cinq des six tâches ont été capturées, avec un total de 7 pages.
  • Les trois fichiers PDF portrait sont devenus des pages de 210 par 297 mm, une pour chaque page source.
  • Le PDF paysage et le PNG sont devenus des pages paysagées de 297 par 210 mm.
  • Chaque billet précisait du papier A4, une copie, une sortie monochrome, et 150 par 150 DPI.
  • Le GIF a été enregistré comme un échec avec une erreur de type de fichier non supporté.
  • L'exécution avec aucune telle imprimante 12345 s'est arrêtée avant toute tâche et a laissé le dossier de capture inchangé.
  • Une lecture indépendante des fichiers XPS a correspondu à chaque chiffre dans l'enregistrement de course.
  • Un nouveau départ de la construction d'acceptation a produit les mêmes cinq captures.
  • Le scan de la clé n'a trouvé aucune copie de la clé de licence dans le dossier du projet.
  • L'invite d'installation a conservé la version 2026.10.1.
  • L'invite de documentation n'a changé aucun code.
  • Sa réponse a signalé que le guide d'impression silencieuse et le fichier de compétences sont en désaccord sur GIF et HTML.
  • Un nouveau CLAUDE.md a reçu les règles de l'invite de configuration et les comportements mesurés.
  • L'auto-contrôle a confirmé que les cinq tâches capturées avaient les réglages demandés.
  • Certaines étapes ont été exécutées différemment de la page. L'invite d'acceptation a été exécutée d'abord, suivie par les invites des étapes 1, 3, 5, et 7 dans la même session. L'application a correspondu à PRINTER_NAME sans tenir compte de la casse et a transmis le nom exact de la liste d'imprimantes.

Ce qui passe

  • La construction de Publication réussit sans modifications manuelles du code.
  • L'application s'arrête avant toute tâche lorsque IsLicensed est faux ou lorsque PRINTER_NAME n'est pas dans Printer.GetPrinterNames.
  • Chaque fichier imprimable a une capture XPS dont les pages, les tailles de pages, et les valeurs de tickets correspondent à runrecord.md lorsque vous lisez vous-même les fichiers XPS.
  • Le GIF est enregistré comme un échec, et le lot continue.
  • La clé de licence est absente de chaque fichier de projet.
Veuillez noter: Pour une autre version d'IronPrint, changez la version à l'étape 1 de l'invite et lisez d'abord le journal des modifications d'IronPrint.

L'enregistrement de l'exécution

  • Toutes les exécutions ont utilisé un ordinateur de bureau Windows 11 x64 avec un Core i9-14900KF et 64 Go de mémoire.
  • Aucun guide n'a envoyé une tâche à une imprimante physique.
  • Le projet de ce guide cible net9.0-windows et épingle IronPrint 2026.10.1, avec Lib.Harmony 2.3.6 pour son mode de capture.
  • La durée d'un guide est la somme des temps enregistrés pour les prompts sur sa page, et cette ligne de guide ne compte que le prompt d'acceptation.
  • Les versions et modèles des outils dans le tableau proviennent des fichiers de session et des journaux de chaque outil pour l'exécution, et non d'une vérification de version séparée.
  • Dernier test le 15 octobre 2026, pour ce guide, Claude Code, ChatGPT Codex, GitHub Copilot (invites 1 et 2 seulement) et Google Antigravity, et le 16 octobre 2026 pour Cursor.
GuideAssistant et versionModèleDurée (minutes)
Ce guideClaude Code 2.1.277, une session, invites de permission désactivéesClaude Opus 523.7
Claude CodeClaude Code 2.1.277, alias opusplan, invite 3 en mode planClaude Sonnet 5, avec Claude Opus 5 planifiant l'invite 316.4
ChatGPT CodexCodex CLI 0.160.0, d'une seule traiteGPT-6 Luna17.9
GitHub CopilotCopilot CLI 1.0.95, arrêtée à l'invite 2 par le quota mensuelGPT-6 Luna, choisi par Auto1.5, invites 1 et 2 seulement
CursorCursor 3.23.23 application de bureau, invite 3 en mode planGrok 4.7102.8
Google AntigravityAntigravity CLI 1.3.5, qui s'est mis à jour à 1.3.6 pendant l'invite 1, invites 1 et 5 envoyées avec /plan, invites d'autorisation sautéesGemini 3.8 Flash (Élevé)61.9

Guides spécifiques aux agents

Chaque guide d'outil construit une tâche d'impression avec ces étapes.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

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

Prêt à commencer ?

Téléchargements NuGet 52,106Version :2026.11tout juste publié