Utiliser IronPrint avec les assistants de codage IA
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.
Comment utiliser IronPrint avec un assistant de codage IA
- Téléchargez la bibliothèque d'impression C# depuis NuGet
- Ciblez un framework spécifique à l'OS tel que
net9.0-windows - Assignez
IronPrint.License.LicenseKeydepuisIronPrint_LICENSE_KEYavant la première tâche - Fournissez à l'assistant l'index de llms.txt d'IronPrint avant que du code ne soit écrit
- Enregistrez les règles d'IronPrint dans le fichier que votre assistant charge à chaque session
- Vérifiez chaque nom d'imprimante avec
Printer.GetPrinterNameset confirmez ce que chaque tâche envoie
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.Printingdé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.
La commande .NET CLI épingle la même version.
dotnet add package IronPrint --version 2026.10.1
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.
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");
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.
É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.
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.
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.
É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 avecPrintSettingsdé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,
PrintAsyncn'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 quePrinter.GetPrinterNamesa renvoyés. Printsur 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. UtilisezPrintAsync.- 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.
ShowPrintDialogsur une cible simple : la page de dépannage indique que l'appel peut lancer une AggregateException sur une cible .NET simple. Sous Windows, une constructionnet9.0n'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.
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.A4a produit des pages 210 par 297 mm, etPaperSize.Lettera produit des pages 215,9 par 279,4 mm.- Avec
PaperOrientation.Automatic, une page paysage a été imprimée comme une page paysage. AvecPortrait, 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. NumberOfCopiesa 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.
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.
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
IsLicensedest faux ou lorsquePRINTER_NAMEn'est pas dansPrinter.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.
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-windowset épingleIronPrint2026.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.
| Guide | Assistant et version | Modèle | Durée (minutes) |
|---|---|---|---|
| Ce guide | Claude Code 2.1.277, une session, invites de permission désactivées | Claude Opus 5 | 23.7 |
| Claude Code | Claude Code 2.1.277, alias opusplan, invite 3 en mode plan | Claude Sonnet 5, avec Claude Opus 5 planifiant l'invite 3 | 16.4 |
| ChatGPT Codex | Codex CLI 0.160.0, d'une seule traite | GPT-6 Luna | 17.9 |
| GitHub Copilot | Copilot CLI 1.0.95, arrêtée à l'invite 2 par le quota mensuel | GPT-6 Luna, choisi par Auto | 1.5, invites 1 et 2 seulement |
| Cursor | Cursor 3.23.23 application de bureau, invite 3 en mode plan | Grok 4.7 | 102.8 |
| Google Antigravity | Antigravity 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ées | Gemini 3.8 Flash (Élevé) | 61.9 |
Guides spécifiques aux agents
Chaque guide d'outil construit une tâche d'impression avec ces étapes.
- Utilisez IronPrint avec Claude Code pour router chaque type de document de laboratoire vers une imprimante nommée et refusant les noms que la machine n'a pas
- Utilisez IronPrint avec ChatGPT Codex pour une tâche nocturne d'entrepôt qui imprime des listes de prélèvement avec un nombre de copies par commande
- Utilisez IronPrint avec GitHub Copilot pour un service de dépôt qui imprime des formulaires de remise PDF remplis, aplatis avant l'impression
- Utilisez IronPrint avec Cursor pour migrer l'impression de bordereau d'emballage et d'étiquettes de
System.Drawing.Printingvers les paramètres d'impression d'IronPrint - Utilisez IronPrint avec Google Antigravity pour une application web de réception d'hôtel qui imprime une carte d'enregistrement depuis un contrôleur
Dépannage
- Méthode Print() bloquée dans WPF et WinForms pour une interface qui cesse de répondre pendant une impression synchrone
- Comportement de ShowPrintDialog sur des frameworks cibles non pris en charge pour des appels de dialogue sur un framework cible simple
- Orientation par page perdue lors de l'impression de PDF mixtes lorsqu'un PDF avec des pages portrait et paysage s'imprime en une seule orientation
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.