Usar IronPrint con asistentes de codificación IA

Curtis Chau
Curtis Chau
Actualizado: 26 de octubre de 2026

IronPrint es la biblioteca de impresión de Iron Software para .NET. Envía archivos PDF e imágenes desde código C# a una impresora, ya sea silenciosamente o mediante el diálogo de impresión del sistema, en Windows, macOS, iOS y Android.

La impresión es el último paso de muchas funciones de documentos y un paso difícil de probar, porque su salida deja la máquina. Sin la documentación de IronPrint, un asistente no puede decir qué miembros existen. Proporcione la documentación antes de la primera solicitud.

Cada asistente necesita los mismos cuatro pasos. Agregue el paquete, lea la clave del entorno, dé al asistente la documentación legible por máquina de IronPrint e inspeccione lo que contiene cada trabajo antes de cerrar la tarea. Los mismos pasos cubren impresión silenciosa, elección de una impresora por nombre, configuración de impresión y diálogo de impresión.

Logotipo del asistente de codificación AI Claude CodeLogotipo del asistente de codificación AI ChatGPT CodexLogo del asistente de codificación AI GitHub CopilotLogo del editor de código AI CursorLogo del agente de codificación AI Google Antigravity

¿Mi asistente de IA no puede manejar la impresión por sí solo?

La guía de impresión silenciosa describe la ruta System.Drawing.Printing como un PrintDocument con un controlador de eventos de página para cada tipo de documento y sin renderizado PDF incorporado.

La API de IronPrint se centra en dos clases, Printer y PrintSettings, y el Paso 3 enumera la documentación legible por máquina que las describe.

Se aplican tres puntos antes de que un asistente escriba la primera llamada de impresión.

  • El código de impresión improvisado cuesta tokens: cada intento de reconstruir una configuración faltante desde llamadas System.Drawing.Printing en bruto gasta tokens, y ese código arroja una TypeInitializationException en macOS.
  • El nombre del paquete importa: tanto el paquete NuGet como el espacio de nombres son IronPrint. Slopsquatting es el registro de nombres de paquetes que los modelos de lenguaje producen para paquetes inexistentes, por lo que el aviso debe nombrar el paquete exactamente.
  • No hay tarifa recurrente por licencias: las licencias de IronPrint son perpetuas. Cada nivel en la página de licencias establece su propio límite de desarrolladores, ubicación y proyecto.

Paso 1: Instalar IronPrint

Pídale al asistente que agregue el paquete y nombre la versión que resolvió.

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

El comando de .NET CLI fija la misma versión.

dotnet add package IronPrint --version 2026.10.1
SHELL

El marco de destino determina qué ruta de impresión utiliza el paquete. Una compilación net9.0-windows carga la ruta de impresión WPF de IronPrint, y una compilación net9.0 sencilla en Windows carga una ruta construida sobre System.Drawing.Printing. Las dos rutas informan nombres de bandejas diferentes para la misma impresora. Para Adobe PDF, el camino WPF devolvió AutoSelect, mientras que la versión simple devolvió Seleccionar automáticamente y Solo uno. macOS requiere el objetivo net9.0-macos o net9.0-maccatalyst con la carga de trabajo correspondiente, y Linux no es una plataforma de impresión compatible.


Paso 2: Aplique su clave de licencia

Sin una clave, un programa aún puede listar impresoras y sus bandejas, pero PrintAsync lanza IronSoftware.Exceptions.LicensingException con el mensaje Se requiere licencia de producción antes de que se cree un trabajo. Print lanza la misma excepción envuelta en System.AggregateException. Con una clave inválida, el mensaje es Clave de licencia no reconocida en su lugar. Por lo tanto, un programa sin licencia no produce ninguna salida en absoluto, con marca de agua o de otro tipo. El formulario a continuación emite una clave de prueba gratuita.

Empiece a usar IronPrint en su proyecto hoy con una prueba gratuita.

Primer paso:
arrow pointer

Establezca la clave una vez cuando la aplicación se inicie, antes de la primera llamada a IronPrint. La clave proviene de una variable de entorno, por lo que ningún commit la contiene.

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

Una vez que se asigna una clave válida, IronPrint.License.IsLicensed devuelve verdadero. IronPrint.License.IsValidLicense prueba cualquier cadena de clave. La biblioteca nunca lee IRONPRINT_LICENSE_KEY por sí sola, y en la sonda de este artículo, establecer la variable sin la asignación dejó IsLicensed falso.

Por favor, tenga en cuenta: Claves de licencia de IronPrint también cubre la configuración de la clave en Web.config, App.config, o appsettings.json.

Paso 3: Indique a su asistente la documentación del LLM de IronPrint

  • llms.txt indexa 43 páginas, una línea cada una. Inclúyalo en cada nueva sesión.
  • llms-full.txt contiene un resumen de cada una de las 33 páginas de documentación en un archivo.
  • llms-full-catalog.txt es el índice con los artículos del blog incluidos.
  • La referencia de objetos proporciona la firma de cada miembro.
  • Las herramientas que leen archivos de habilidad pueden cargar skill.md. Sus secciones cubren instalación, licencias, recetas de impresión, implementación en plataforma y soluciones para fallos conocidos.
  • La Fichar Técnica del Producto IA lista las plataformas soportadas y los principales casos de uso.

Si una tarea depende de una guía específica, dirija al asistente a esa página.

Envíe el índice con una instrucción para mantenerse dentro de él.

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 línea sobre miembros dudosos permite que el asistente informe una brecha en lugar de inventar un miembro.


Paso 4: Agregue el contexto de IronPrint a su proyecto

Las instrucciones de chat terminan con la sesión, por lo que las reglas de IronPrint van en un archivo de proyecto que la herramienta lee cada vez. Claude Code carga CLAUDE.md, ChatGPT Codex carga AGENTS.md, y el archivo de GitHub Copilot es .github/copilot-instructions.md. Cursor carga reglas .mdc desde .cursor/rules/así como AGENTS.md, y Google Antigravity carga AGENTS.md o GEMINI.md. El mismo texto funciona en cada archivo, con frontmatter MDC añadido para una regla de Cursor. Comience desde este bloque.

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

El ejemplo de archivo único del archivo de habilidades todavía fija IronPrint 2026.8.1, dos versiones más antiguas que el paquete 2026.10.1 probado aquí.


Paso 5: Prompt de Configuración de Un Solo Paso

Este aviso combina los Pasos 1 a 4 en un solo mensaje, enviado cuando comienza un proyecto o una sesión.

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
Consejos: Después, verifique el archivo del proyecto del Paso 4 para confirmar que las reglas fueron escritas.

Paso 6: Patrones de Prompt que Producen Código Funcional

Diga de dónde proviene el nombre de la impresora, qué tipo de archivo se imprime y cada configuración de impresión.

Vago Imprima la factura con IronPrint.

Mejor Tome el nombre de la impresora de la configuración, confirme que aparece en Printer.GetPrinterNames e imprima invoice.pdf con PrintSettings configurado a A4, orientación automática, escala de grises y dos copias.

Nombre la versión de IronPrint y el marco de destino para el que es el código.

Mejor Utilice IronPrint 2026.10.1 en net9.0-windows y asigne la clave de IronPrint_LICENSE_KEY antes del primer trabajo.

Pide archivos completos. Un fragmento puede omitir la directiva using IronPrint; y la línea que asigna la clave.

Mejor Devuelva todo Program.cs con cada directiva using y la asignación de licencia en él, para que se construya sin ediciones.


Paso 7: Verifica lo que Recibes

Las sondas con 2026.10.1 midieron el comportamiento detrás de cada error a continuación.

  • Nombres de impresoras sin verificar: un nombre que no coincide con ninguna impresora instalada no genera error. En nuestra prueba, PrintAsync no arrojó ninguna excepción, y el trabajo fue a la impresora predeterminada, Microsoft Print to PDF, que lo retuvo hasta que una persona respondió a su diálogo Guardar como. Acepte solo los nombres que Printer.GetPrinterNames devolvió.
  • Print en un hilo de UI: la llamada síncrona bloquea el hilo que la llama, lo que congela las interfaces WPF y WinForms, como explica la página de resolución de hang. Use PrintAsync.
  • Una impresora de prueba que solicita: dos trabajos enviados a Microsoft Print to PDF se completaron solo después de que una persona escribiera un nombre de archivo. Una prueba sin supervisión necesita una impresora que se complete por sí sola, o el método de captura en la siguiente sección.
  • ShowPrintDialog en un objetivo simple: la página de resolución de problemas dice que la llamada puede generar una AggregateException en un objetivo .NET simple. En Windows, una compilación net9.0 simple no arrojó error. La llamada abrió un diálogo de impresión real y solo regresó cuando el diálogo se cerró, después de 10.1 segundos. Mantenga las llamadas de diálogo fuera del código sin supervisión.

Deja que el Agente Verifique su Propio Trabajo

Pídale al asistente que ejecute estas verificaciones e informe la evidencia.

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

Trabajos de impresión silenciosos con IronPrint

En Windows, IronPrint 2026.10.1 pasa cada trabajo a la clase de diálogo de impresión de WPF sin mostrarlo, con un boleto de impresión que contiene las configuraciones. Un parche de prueba interceptó esa llamada y guardó cada trabajo como un archivo XPS, por lo que las cifras de esta sección se midieron sin papel.

  • Cada página PDF se representa como una imagen en la configuración Dpi. Una página A4 se convirtió en una imagen de 1240 por 1753 píxeles a 150 DPI en la ejecución a continuación, y una imagen de 2479 por 3508 píxeles a 300 DPI en nuestra sonda.
  • PaperSize.A4 produjo páginas de 210 por 297 mm, y PaperSize.Letter produjo páginas de 215.9 por 279.4 mm.
  • Con PaperOrientation.Automatic, una página en formato horizontal se imprimió como una página en formato horizontal. Con Portrait, la misma página fue reducida para ajustar una hoja en orientación vertical y llenó solo su parte superior.
  • Una página PDF en color llegó como una imagen en escala de grises cuando Grayscale estaba activado. El texto rojo en un PNG se mantuvo rojo, y solo el boleto de impresión solicitó una salida monocromática para él.
  • NumberOfCopies estableció el conteo de copias del boleto, y el trabajo aún contenía un conjunto de páginas.

La guía de configuración de impresión dice que la impresora puede limitar el DPI y que algunas plataformas ignoran el conteo de copias, por lo que ambos valores son solicitudes al controlador.


Formatos de archivo con IronPrint

En 2026.10.1, se imprimen archivos PDF, PNG, JPG, BMP y TIFF. Los archivos GIF y HTML lanzan System.IO.InvalidDataException con el mensaje Tipo de archivo no compatible antes de que se cree un trabajo, aunque la guía de impresión silenciosa enumera ambos formatos. El archivo de habilidad enumera los cinco formatos que funcionan. Renderice HTML a PDF primero, por ejemplo con IronPDF.

Una imagen se imprime como una sola página, escalada al ancho de la página. Un PNG de 1200 por 800 píxeles se imprimió en una página A4 horizontal con orientación Automatic, y en la parte superior de una página vertical con Portrait.


Un Resultado que Puedes Reproducir

La prueba es un solo aviso, y todo el código proviene del asistente. Cree una carpeta vacía, abra una nueva sesión en ella, pegue el aviso y verifique el resultado contra la lista bajo Lo que pasa.

Por favor, tenga en cuenta: Los requisitos son Windows, el SDK .NET 9, un asistente que ejecuta comandos de terminal, acceso a la red para NuGet y la documentación, una clave de prueba o producción de IronPrint en IRONPRINT_LICENSE_KEY, y el nombre de una impresora instalada en PRINTER_NAME. El aviso captura cada trabajo en un archivo XPS, por lo que la impresora no recibe nada.

El prompt

Dado que la aplicación escribe su propio conjunto de pruebas, los seis archivos de la ejecución de prueba se unen a continuación en orden de impresión. Sus cuatro PDFs no han cambiado, y el PNG y GIF aparecen cada uno en una página de su propio tamaño de píxeles.

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

Resultado

El registro de ejecución sin editar del trabajo proporciona los valores medidos para cada uno de los seis archivos.

Cada página que escribió la captura está en el PDF a continuación, en orden de impresión.

Salida por lotes conforme IronPrint construyó los trabajos, capturada en archivos XPS en lugar de una impresora y convertida a PDF página por página sin ediciones.

  • La compilación Release net9.0-windows reportó 0 advertencias y 0 errores.
  • La autoprueba del parche pasó con un paginador nulo y no escribió ningún archivo.
  • Cinco de los seis trabajos fueron capturados, con 7 páginas en total.
  • Los tres PDFs en formato vertical se convirtieron en páginas de 210 por 297 mm, una para cada página de origen.
  • El PDF en formato horizontal y el PNG se convirtieron en páginas de 297 por 210 mm en formato horizontal.
  • Cada boleto especificó papel A4, una copia, salida en escala de grises, y 150 por 150 DPI.
  • El GIF se registró como una falla con un error de tipo de archivo no compatible.
  • La ejecución con No Such Printer 12345 se detuvo antes de cualquier trabajo y dejó la carpeta de captura sin cambios.
  • Una lectura independiente de los archivos XPS coincidió con cada cifra en el registro de ejecución.
  • Un nuevo inicio de la construcción de aceptación produjo las mismas cinco capturas.
  • El escaneo de claves no encontró copia de la clave de licencia en la carpeta del proyecto.
  • El aviso de instalación mantuvo el pin de 2026.10.1.
  • El aviso de documentación no cambió ningún código.
  • Su respuesta informó que la guía de impresión silenciosa y el archivo de habilidad no están de acuerdo sobre GIF y HTML.
  • Un nuevo CLAUDE.md recibió las reglas del aviso de configuración y los comportamientos medidos.
  • La autocomprobación confirmó que todos los cinco trabajos capturados tenían las configuraciones solicitadas.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. El aviso de aceptación se ejecutó primero, seguido de los avisos de los pasos 1, 3, 5 y 7 en la misma sesión. La aplicación coincidió PRINTER_NAME sin importar el caso y pasó el nombre exacto de la lista de impresoras.

Lo que pasa

  • La compilación Release tiene éxito sin ediciones manuales al código.
  • La aplicación se detiene antes de cualquier trabajo cuando IsLicensed es falso o cuando PRINTER_NAME no está en Printer.GetPrinterNames.
  • Cada archivo imprimible tiene una captura XPS cuyas páginas, tamaños de página y valores de boletos coinciden con runrecord.md cuando lee los archivos XPS usted mismo.
  • El GIF se registra como una falla, y el lote continúa.
  • La clave de licencia está ausente de todos los archivos de proyecto.
Por favor, tenga en cuenta: Para otra versión de IronPrint, cambie la versión en el paso 1 del aviso y lea primero el registro de cambios de IronPrint.

El récord de ejecución

  • Todas las ejecuciones utilizaron un escritorio Windows 11 x64 con un Core i9-14900KF y 64 GB de memoria.
  • Ninguna guía envió un trabajo a una impresora física.
  • El proyecto de esta guía se dirige a net9.0-windows y fija IronPrint 2026.10.1, con Lib.Harmony 2.3.6 para su modo de captura.
  • La duración de una guía es la suma de los tiempos registrados para los avisos en su página, y el recuento de filas de esta guía solo incluye el aviso de aceptación.
  • Las versiones y modelos en la tabla provienen de los archivos de sesión y registros de la propia herramienta para la ejecución, no de una verificación de versión separada.
  • Última prueba octubre 15, 2026, para esta guía, Claude Code, ChatGPT Codex, GitHub Copilot (solo avisos 1 y 2) y Google Antigravity, y octubre 16, 2026, para Cursor.
GuíaAsistente y versiónModeloDuración (minutos)
Esta guíaClaude Code 2.1.277, una sesión, mensajes de permiso desactivadosClaude Opus 523.7
Claude CodeClaude Code 2.1.277, alias opusplan, aviso 3 en modo planClaude Sonnet 5, con Claude Opus 5 planificando el aviso 316.4
ChatGPT CodexCLI del Codex 0.160.0, una sesiónGPT-6 Luna17.9
GitHub CopilotCLI de Copilot 1.0.95, detenido en el aviso 2 por la cuota mensualGPT-6 Luna, elegido por Auto1.5, solo avisos 1 y 2
CursorAplicación de escritorio Cursor 3.23.23, aviso 3 en Modo PlanGrok 4.7102.8
Google AntigravityCLI de Antigravity 1.3.5, que se actualizó a sí mismo a 1.3.6 durante el aviso 1, los avisos 1 y 5 enviados con /plan, se omitieron los avisos de permisoGemini 3.8 Flash (Alto)61.9

Guías Específicas del Agente

Cada guía de herramientas construye una tarea de impresión con estos pasos.


Solución de problemas


¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 52,106Versión:2026.11recién lanzado