Cómo usar IronPrint con Cursor
Cuando un agente de IA transfiere un servicio de impresión C# de System.Drawing.Printing a IronPrint, una configuración copiada sin cambios aún se compila y cambia su significado. Un margen de 50 en el código antiguo significa medio pulgada, mientras que el mismo 50 en IronPrint significa 50 milímetros. Los nombres de las impresoras se transfieren sin cambios también. En nuestras pruebas, IronPrint envió un trabajo para un nombre de impresora que no estaba instalado a la impresora predeterminada sin generar un error.
Cursor, que está basado en el código de VS Code, agrega un agente al editor. El que una migración mantenga estos detalles depende de dos características de Cursor, los enlaces de documentación dados al agente y las reglas del proyecto confirmadas en .cursor/rules. Los ejemplos se aplican tanto a un servicio de oficina de despacho que imprime notas de empaque, etiquetas de estantes y notas de devoluciones. El servicio construye cada trabajo desde un archivo de configuración en centésimas de pulgada, y las indicaciones lo mueven a IronPrint.
Para detalles sobre los ajustes involucrados, consulte la guía de márgenes de papel y la guía de nombres de impresoras.
Inicio rápidoAbra el repositorio de despacho, inicie un nuevo chat de agente y envíe esta solicitud.
@src/DespatchDesk/ @config/despatch.json
Start by fetching https://ironsoftware.com/print/csharp/llms.txt.
Also read the pages it links on printer names and print settings.
Then add a printers command to Program.cs:
`dotnet run --project src/DespatchDesk -- printers`
Have it show what IronPrint reports on this machine:
- Every name from Printer.GetPrinterNames, in square brackets so spaces show.
- The trays GetPrinterTrays returns for each printer, or "none".
- Whether each printer named in config/despatch.json is in that list.
Have the program read IRONPRINT_LICENSE_KEY from the environment.
Set License.LicenseKey from it before anything else runs.
Don't echo the key or dump the environment.
IronPrint stays on version 2026.10.1.
Send no print jobs, and leave DespatchJobs.cs on System.Drawing.Printing for now.
Run the printers command and show me what it prints.
Nunca pegue la clave de licencia en el chat. El agente de Cursor puede editar archivos y ejecutar comandos de shell, por lo que puede copiar una clave pegada en un mensaje de confirmación, un archivo fuente o un registro de compilación. La solicitud tiene al programa asignar IRONPRINT_LICENSE_KEY a License.LicenseKey porque configurar solo la variable dejó IronPrint 2026.10.1 sin licencia en las pruebas. En un sondeo sin clave, IronPrint enumeró impresoras y bandejas, y Printer.Print lanzó un AggregateException en torno a una LicensingException antes de que se enviara cualquier trabajo. La guía de la clave de licencia nombra los lugares de donde IronPrint lee una clave, como appsettings.json.
Flujo de trabajo mínimo (5 pasos)
- Descargue la biblioteca de impresión C# desde NuGet
- Agregue una regla de proyecto en .cursor/rules que contenga el enlace de la documentación de IronPrint.
- Registre en la regla que los márgenes están en milímetros y que los nombres de las impresoras deben coincidir exactamente.
- Referencie el código de impresión y el informe de configuración aprobado en cada solicitud.
- Compare las configuraciones de cada trabajo con ese informe, luego confirme cada nombre de miembro en la referencia de API.
¿Qué modelo de Cursor debería usar para el trabajo con IronPrint?
Composer es el modelo agente propio de Cursor. El selector de modelos también ofrece los modelos Grok de SpaceXAI, que Cursor co-desarrolló, y modelos de OpenAI, Anthropic, Google y otros laboratorios. La prueba a continuación utilizó Grok 4.7.
¿Cómo le das a Cursor la documentación de IronPrint?
Coloque el enlace de la documentación de IronPrint en cada solicitud, o una vez en una regla de proyecto para todo el equipo. El llms.txt de IronPrint enumera cada guía, ejemplo y página de resolución de problemas con un resumen, y llms-full.txt contiene resúmenes de 33 páginas de documentación. A partir de octubre de 2026, Cursor enumera carpetas, archivos, chats pasados, el navegador, terminales y diferencias de Git en su menú @, por lo que el agente obtiene la documentación de IronPrint como un enlace.
La documentación indica que un nombre de impresora nulo selecciona la impresora predeterminada, y la guía de IronPrint sobre cómo especificar un nombre de impresora dice que un nombre no coincidente falla silenciosamente o genera un error. Ninguno de los resultados ocurrió en las pruebas, por lo que la regla del proyecto registra el comportamiento medido en su lugar.
@src/DespatchDesk/Printing/ReprintService.cs
Answer five questions about IronPrint without editing any files:
1. What unit does the Margins class use?
2. Which sides does each value of new Margins(10, 20) set?
3. What does Printer.Print do when PrintSettings.PrinterName is null?
4. What do the docs say about a name GetPrinterNames doesn't return, and does the rule agree?
5. Does NumberOfCopies always produce that many copies?
Base each answer on https://ironsoftware.com/print/csharp/llms.txt or a page linked from it.
Check them against the printers output from the last turn where that helps.
Cite the page behind each answer.
If no page covers a question, say so plainly rather than guess.
¿Cómo escribes reglas de proyecto que codifican tus convenciones de IronPrint?
Las reglas del proyecto son archivos .mdc mantenidos en .cursor/rules y confirmados al repositorio, por lo que cada clon carga las mismas reglas. El sistema de reglas de Cursor ignora un archivo .md simple allí, ya que no contiene metadatos.
Guarde la regla a continuación como .cursor/rules/ironprint-despatch.mdc. Con globs configurado y alwaysApply en falso, Cursor lo adjunta cuando un archivo C# en src/DespatchDesk o pruebas está en el contexto de la solicitud, y lo deja fuera de otras solicitudes.
---
description: IronPrint conventions for the despatch printing code
globs: src/DespatchDesk/**/*.cs, tests/**/*.cs
alwaysApply: false
---
Despatch printing code uses IronPrint and follows these rules:
- Print with IronPrint only.
- Reference IronPrint 2026.10.1 from NuGet and use its IronPrint namespace.
- Do not add another printing package.
- Move existing code to IronPrint only when a request asks for it.
- The IronPrint docs index is https://ironsoftware.com/print/csharp/llms.txt.
- Read the license key from the IRONPRINT_LICENSE_KEY variable.
- Keep the license key out of output and files.
- IronPrint Margins uses whole millimeters, as left, top, right, bottom.
- System.Drawing.Printing.Margins uses hundredths of an inch, as left, right, top, bottom.
- new Margins(a, b) sets left and right to a, and top and bottom to b.
- Printer.Print sends the job to the default printer if PrinterName is not an exact installed name.
- Check the name against Printer.GetPrinterNames before every job.
- Run the print and reprint commands only when I ask for them.
- Check settings with the jobs and reprint-jobs reports instead.
- If an IronPrint member is not in the docs, say that and cite the page you searched.
- Never make up an IronPrint member.
Según la página de reglas de Cursor, el Agente usa reglas, pero Tab no, y las reglas de usuario se omiten en la edición en línea. Revise las sugerencias de Tab y edición en línea en función de la regla manualmente.
¿Cómo mapeas las configuraciones de System.Drawing.Printing a IronPrint?
Una solicitud para usar IronPrint no indica qué configuración de IronPrint reemplaza cada configuración de PrintDocument. La tabla a continuación proporciona ese mapeo.
| System.Drawing.Printing | IronPrint |
|---|---|
PrinterSettings.PrinterName | PrintSettings.PrinterName |
PageSettings.PaperSize, dimensionado en centésimas de pulgada | El enum PaperSize, como PaperSize.A4 |
PageSettings.Landscape | PaperOrientation.Landscape o PaperOrientation.Portrait |
PageSettings.Margins, centésimas de pulgada, izquierda, derecha, arriba, abajo | PaperMargins con un valor de Margins, milímetros enteros, izquierda, arriba, derecha, abajo |
PrinterSettings.Copies | NumberOfCopies |
PageSettings.Color configurado en falso | Grayscale configurado en verdadero |
PrintDocument.Print con un controlador de PrintPage | Printer.Print con una ruta de archivo y las configuraciones |
Un margen configurado de 50 es 12.7 milímetros, lo que se redondea a 13 porque el constructor toma números enteros. La guía de tamaños de papel de IronPrint enumera el orden de cuatro valores como arriba, derecha, abajo, izquierda, mientras que la documentación XML enviada y una investigación de la biblioteca ambos dan izquierda, arriba, derecha, abajo.
¿Cómo planeas y ejecutas una migración a IronPrint?
Shift+Tab alterna los modos del chat. Detente en el Modo Plan y envía la solicitud a continuación. Cursor guarda el plan en un archivo markdown, que se puede editar antes de la aprobación.
@src/DespatchDesk/Printing/ @TestData/expected-jobs.tsv
Plan the move of DespatchJobs from System.Drawing.Printing to IronPrint.
Write no code until I approve.
ReprintService already uses IronPrint, so keep it out of this plan.
The plan needs to cover these points:
- Each PrintDocument setting DespatchJobs uses, with its PrintSettings replacement or none.
- How margins in hundredths of an inch become IronPrint margins, including the order of the sides.
- How the jobs command keeps its columns and its values.
Keep config/despatch.json, JobSummary and the public Describe and Print signatures unchanged.
Where something is unclear, write down the assumption you made.
Edite el plan donde esté incorrecto. Para aprobarlo, haga clic en Construir, o regrese al modo Agente y envíe esta solicitud.
@ironprint-despatch
Go ahead with the approved plan.
TestData/expected-jobs.tsv holds the jobs report the despatch office signed off.
A row matches when all eight columns agree with it.
Then follow these four steps:
1. Run `dotnet run --project src/DespatchDesk -- jobs` and count the matching rows.
2. Move DespatchJobs to IronPrint.
3. Remove System.Drawing.Common from the project file.
4. Build the solution and run the jobs command a second time.
Tell me the match count before and after the move, then show me the diff.
La mención @ironprint-despatch agrega la regla a la solicitud por nombre. El informe de trabajos imprime la configuración de cada documento sin enviar un trabajo, por lo que la comparación funciona en una máquina sin impresora conectada.
¿Qué característica de Cursor encaja con cada cambio?
Elija la característica por el tamaño del cambio. Tab ofrece el resto de una edición ya en curso. La edición en línea (Ctrl+K) cambia el código seleccionado a partir de una instrucción de una oración. El agente se adapta a un cambio que abarca varios archivos o necesita una compilación. El Modo Plan vale el esfuerzo extra cuando deshacer un cambio incorrecto lleva más tiempo que escribir un plan, y un Agente en la Nube maneja trabajos desatendidos.
Seleccione el método Print de DespatchJobs y agréguelo al chat como contexto con Ctrl+Shift+L, o Cmd+Shift+L en macOS. Luego, envíe esta solicitud desde el modo Agente.
Make DespatchJobs.Print refuse a printer that isn't installed:
- Check the name against Printer.GetPrinterNames before anything is sent.
- Use an ordinal, case-sensitive comparison so spaces and case must match too.
- If it's missing, throw an error whose message includes every installed printer name.
- Have the print command show that message and exit with code 2.
Then run these two commands and show me what each one prints:
`dotnet run --project src/DespatchDesk -- print packing-slip`
`dotnet run --project src/DespatchDesk -- print packing-slip --printer "adobe pdf"`
El segundo comando difiere de un nombre de impresora instalado solo en mayúsculas.
¿Qué pasa cuando IronPrint no puede encontrar el nombre de la impresora?
El servicio antiguo se detuvo con un error. System.Drawing.Printing lanzó una InvalidPrinterException con el mensaje "Las configuraciones para acceder a la impresora 'Despatch-A4-01' no son válidas." IronPrint 2026.10.1 dirigió el trabajo capturado para ese nombre, y para otros tres nombres, a la impresora predeterminada. Estos fueron el nombre de impresora de muestra de la guía de márgenes de IronPrint, una impresora instalada escrita en minúsculas, y la misma impresora con un espacio final.
Microsoft Print to PDF, que era la impresora predeterminada de la máquina de prueba, pide un nombre de archivo, por lo que un servicio desatendido se habría detenido en un cuadro de diálogo Guardar como. La guía de nombres de impresoras establece que cada nombre devuelto coincide exactamente con el nombre en las configuraciones de impresoras de Windows, lo que convierte a una comparación ordinal con Printer.GetPrinterNames en la verificación a ejecutar antes de cada trabajo.
¿Cómo depuras dos rutas de impresión que no coinciden?
El código del quiosco de reimpresión ya usaba IronPrint, y su informe de configuraciones no coincide con el informe aprobado en cada fila.
@src/DespatchDesk/Printing/ReprintService.cs @TestData/expected-jobs.tsv
Find out why the reprint report disagrees with expected-jobs.tsv on every row.
The jobs report matches it, and both read config/despatch.json.
Work through these steps before changing any code:
1. Run the reprint-jobs command and the jobs command, and compare them.
2. List each column where reprint-jobs differs, per document type.
3. Explain what ReprintService does to cause each difference.
Then fix ReprintService and keep it on IronPrint.
Give its Print method the same printer check.
Keep the check out of BuildSettings and Describe, since reprint-jobs reads those.
Run reprint-jobs again and tell me how many rows match, before and after the fix.
El desacuerdo tiene dos causas. El código del quiosco pasa las centésimas directamente al constructor de dos valores, por lo que una nota de empaque informa márgenes de 50 milímetros, y la nota de devolución repite su valor superior en la parte inferior, donde la configuración establece 80 centésimas. También establece la orientación horizontal para cada documento porque fue escrito para etiquetas de estantes.
Resultado
En una captura de la ejecución antes de la corrección, la nota de empaque retrato enviada con orientación horizontal se dispuso en una hoja de 297 x 210 milímetros. Su página fue escalada a 148.4 por 209.9 milímetros, y los otros 148.5 milímetros de la hoja quedaron en blanco.
Nota de empaque con las configuraciones del ReprintService no corregidas, tal como IronPrint construyó el trabajo, capturado a un archivo en lugar de a una impresora.
¿Qué envía IronPrint a la impresora?
Ninguna de las cuatro impresoras en la máquina de prueba completa un trabajo desatendido, por lo que nada se imprimió en papel. Para estas medidas, las muestras de la guía de márgenes y el servicio migrado se ejecutaron sin cambios, y solo se reemplazó la llamada final a la impresión en Windows. En esa llamada, un parche guardó las páginas de cada trabajo y el ticket de impresión como un archivo XPS, y la cola de impresión no recibió nada. Las medidas a continuación provienen de esos archivos y describen lo que recibiría una impresora.
- Márgenes: márgenes de 0, 10, 15, 20, 30 y 50 milímetros producían páginas idénticas, con la imagen de la página llenando la hoja. La versión System.Drawing.Printing de la nota de empaque dibujó su imagen dentro de márgenes de 12.7 milímetros.
- Escala de grises: para una página PNG, la configuración solo cambió el ticket de impresión y la imagen permaneció en color. Para una página PDF, la imagen en sí era gris.
- Resolución: un PDF se representó en la configuración de
Dpi, 2479 por 3508 píxeles para A4 a 300. Un PNG se envió con su propio tamaño de píxel.
Hasta que IronPrint aplique PaperMargins a la página en Windows, un diseño que necesita espacio en blanco en los bordes debe llevarlo en el mismo documento.
Entrada
El servicio imprime tres archivos PNG de TestData/jobs, slip-1001.png, labels-aisle-07.png y return-2207.png. Cada uno es una imagen de 150 DPI con un borde rojo en sus bordes.
Resultado
Los PDFs a continuación muestran un trabajo cada uno del código que Cursor escribió. Cada imagen de página es inalterada y mantiene el tamaño de la página capturada.
Nota de empaque como IronPrint construyó el trabajo, capturado a un archivo en lugar de a una impresora. El trabajo sostiene una página A4 en formato retrato, y su ticket de impresión solicita dos copias en monocromo.
Etiquetas de estantes como IronPrint construyó el trabajo, capturado a un archivo en lugar de a una impresora. Esta página A4 en formato horizontal mide 297 por 210 milímetros, y el ticket de impresión especifica salida a color.
Nota de devoluciones como IronPrint construyó el trabajo, capturado a un archivo en lugar de a una impresora. Su única página A5 en formato retrato mide 148 por 210 milímetros, y la salida monocromática está configurada en el ticket de impresión.
¿Cómo escribes pruebas de regresión para código de impresión?
Los Cloud Agents de Cursor se ejecutan en máquinas Ubuntu, y el ejemplo apunta a net9.0-windows, por lo que envíe esta solicitud en un chat local de Agente.
@tests/DespatchDesk.Tests/ @TestData/
Write xUnit tests for DespatchJobs and ReprintService. None of them may send a print job.
Cover these cases with tests:
- Describe returns every row of TestData/expected-jobs.tsv, for both classes.
- The returns note reports a 20 mm bottom margin.
- Print throws when the printer is missing from GetPrinterNames.
- That error message names each printer GetPrinterNames returns when the test runs.
- An installed printer name with its case changed is refused as well.
- Hundredths of an inch convert to the millimeters in expected-jobs.tsv.
Link config and TestData from the repo root into the test output, keeping their relative paths.
Leave expected-jobs.tsv as it is, then run dotnet test.
Tell me how many tests passed and how many failed.
Las pruebas de rechazo utilizan nombres de impresoras que no están instaladas, por lo que se detienen en la verificación de impresora antes de que se llame Printer.Print.
La guía de asistentes de codificación de IA toma una tarea de IronPrint desde una carpeta vacía hasta un resultado verificado contra criterios de aprobación por escrito.
¿Qué produjeron los prompts en una ejecución real?
Cursor recibió las siete solicitudes en orden contra el repositorio de ejemplo de despacho. Después de la ejecución, las nuevas compilaciones de Release de cada confirmación que cambió el código repitieron cada informe y comando a continuación.
- Antes del cambio a IronPrint y después, el informe de trabajos coincidió con las 3 filas del informe aprobado.
- El informe de reimpresión coincidió con 0 de 3 filas antes de la corrección y 3 de 3 después de ella.
- El comando de impresoras enumeró las cuatro impresoras instaladas con sus bandejas y marcó ambas impresoras configuradas como no instaladas.
- Cada una de las cinco respuestas de documentación de Cursor citó una página, y ningún archivo cambió.
- Para un nombre que GetPrinterNames no devuelve, Cursor repitió la declaración de la guía y notó que la regla del proyecto describe un resultado diferente.
- El plan no encontró un reemplazo de PrintSettings para el nombre del documento y lo registró como suposición.
- Después del cambio, la aplicación solo hacía referencia al paquete IronPrint, y no quedaba código System.Drawing.Printing.
- DespatchJobs mantuvo sus firmas públicas de Describe y Print.
- El comando de impresión rechazó la impresora configurada para los tres tipos de documentos con el código de salida 2 y una lista de las cuatro impresoras instaladas.
- La verificación de impresoras también rechazó la impresora PDF de Adobe instalada escrita en minúsculas o con un espacio final.
- Antes de su corrección, el comando de reimpresión envió trabajos para una impresora configurada que falta y para "adobe pdf" a la impresora predeterminada.
- Después de la corrección, el comando de reimpresión rechazó ambos nombres. Se detuvo con una excepción no manejada, ya que la solicitud 06 no pidió un código de salida.
- Todas las 9 pruebas de xUnit pasaron. Provienen de cinco métodos de prueba, y ninguno envió un trabajo.
- La ejecución dejó la configuración, los datos de prueba y la regla del proyecto sin cambios.
- Cada compilación de Release terminó con 0 advertencias y 0 errores, y ningún archivo fue editado manualmente.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. Cada solicitud fue enviada manualmente en un chat de escritorio local. La solicitud 04 fue primero pegada sin ser enviada, y fue enviada después de que el script de registro de la ejecución informó que faltaba del chat. El plan fue aprobado enviando la solicitud 04 en Agente, y nunca se hizo clic en Construir. La migración de Cursor ya verificó el nombre de la impresora, como propuso su plan, por lo que la solicitud 05 cambió una verificación existente.
La guía de GitHub Copilot también mantiene archivos de instrucciones específicos de ruta en el repositorio, y la guía de Google Antigravity prueba la página de impresión en un navegador real. El registro de ejecución enumera la versión de la herramienta, el modelo, la duración y la máquina de prueba para cada guía.
Solución de problemas
- Cómo obtener nombres de impresoras para un trabajo que va a la impresora predeterminada en lugar de la nombrada
- Cómo configurar márgenes de papel al convertir márgenes de centésimas de pulgada
- Ajustes de impresión en C# para el valor predeterminado de cada configuración
- Uso de claves de licencia cuando el código de impresión generado falla con una excepción de licencia
¿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.