So verwenden Sie IronPrint mit Cursor

Curtis Chau
Curtis Chau
Aktualisiert: 26. Oktober 2026

Wenn ein KI-Agent einen C#-Druckdienst von System.Drawing.Printing zu IronPrint portiert, wird eine unveränderte Einstellung übernommen, die weiterhin kompiliert und ihre Bedeutung ändert. Ein Rand von 50 im alten Code bedeutet einen halben Zoll, während dieselbe 50 in IronPrint 50 Millimeter bedeutet. Auch die Druckernamen bleiben unverändert. In unseren Tests hat IronPrint einen Auftrag für einen nicht installierten Druckernamen an den Standarddrucker gesendet, ohne einen Fehler zu melden.

Cursor, das auf dem Code von VS Code basiert, fügt dem Editor einen Agenten hinzu. Ob eine Migration diese Details beibehält, hängt von zwei Funktionen von Cursor ab, den dem Agenten gegebenen Dokumentationslinks und den festgelegten Projektrichtlinien in .cursor/rules. Die Beispiele gelten sowohl für einen Versandschalterdienst, der Lieferscheine, Regaletiketten und Rücksendescheine druckt. Der Dienst erstellt jeden Auftrag aus einer Konfigurationsdatei in Hundertstel Zoll, und die Eingabeaufforderungen überführen sie nach IronPrint.

Einzelheiten zu den betroffenen Einstellungen finden Sie im Papiermargen-Leitfaden und im Druckernamen-Leitfaden.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronPrint

Installieren Sie IronPrint, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Öffnen Sie das Versand-Repository, starten Sie einen neuen Agenten-Chat und senden Sie diese Eingabeaufforderung.

@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.
Text

Fügen Sie niemals den Lizenzschlüssel in den Chat ein. Cursors Agent kann Dateien bearbeiten und Shell-Befehle ausführen, daher kann er einen eingefügten Schlüssel in eine Commit-Botschaft, eine Quelldatei oder ein Build-Protokoll kopieren. Die Eingabeaufforderung lässt das Programm IRONPRINT_LICENSE_KEY zu License.LicenseKey zuweisen, da das alleinige Setzen der Variable IronPrint 2026.10.1 in Tests unlizenziert ließ. In einer Probe ohne Schlüssel listete IronPrint Drucker und Fächer auf, und Printer.Print warf eine AggregateException um eine LicensingException, bevor ein Auftrag gesendet wurde. Der Lizenzschlüssel-Leitfaden nennt die Stellen, von denen IronPrint einen Schlüssel liest, wie appsettings.json.



Welches Cursor-Modell sollten Sie für IronPrint-Arbeiten verwenden?

Composer ist Cursors eigenes agentisches Modell. Der Modellwähler bietet auch die Grok-Modelle von SpaceXAI, die Cursor mitentwickelt hat, sowie Modelle von OpenAI, Anthropic, Google und anderen Laboren. Der untenstehende Testrun verwendete Grok 4.7.

Wie geben Sie Cursor die IronPrint-Dokumentation?

Setzen Sie den Link zur IronPrint-Dokumentation in jede Anfrage oder einmal in eine Projektrichtlinie für das gesamte Team. IronPrints llms.txt listet jeden Leitfaden, jedes Beispiel und jede Fehlerbehebungsseite mit einer Zusammenfassung auf, und llms-full.txt enthält Abstracts von 33 Dokumentationsseiten. Ab Oktober 2026 listet Cursor Ordner, Dateien, vergangene Chats, den Browser, Terminals und Git-Diffs in seinem @ Menü auf, sodass der Agent die IronPrint-Dokumentation als Link erhält.

In der Dokumentation wird angegeben, dass ein Null-Druckername den Standarddrucker auswählt, und der IronPrint-Leitfaden zur Angabe eines Druckernamens sagt aus, dass ein unpassender Name stillschweigend fehlschlägt oder einen Fehler auslöst. Keines der beiden Ergebnisse trat in Tests auf, daher dokumentiert die Projektrichtlinie das gemessene Verhalten stattdessen.

@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.
Text

Wie schreiben Sie Projektrichtlinien, die Ihre IronPrint-Konventionen kodieren?

Projektrichtlinien sind .mdc-Dateien, die in .cursor/rules gespeichert und im Repository abgelegt werden, sodass jeder Klon dieselben Richtlinien lädt. Das Regelwerk von Cursor ignoriert dort eine normale .md-Datei, da sie keine vorderen Daten enthält.

Speichern Sie die unten stehende Regel als .cursor/rules/ironprint-despatch.mdc. Mit globs gesetzt und alwaysApply auf false, hängt Cursor sie an, wenn sich eine C#-Datei unter src/DespatchDesk oder tests im Kontext der Anfrage befindet, und lässt sie bei anderen Anfragen außen vor.

---
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.
Markdown
Bitte beachten Sie: Cursor liest auch AGENTS.md-Dateien, im Projektstamm und in Unterverzeichnissen. AGENTS.md ist einfaches Markdown ohne vordere Daten, daher kann es nicht die Globs enthalten, von denen diese Regel abhängt.

Laut Cursors Regelwerk verwendet der Agent Regeln, aber Tab nicht, und Benutzerregeln werden bei der Inline-Bearbeitung nicht berücksichtigt. Überprüfen Sie Vorschläge von Tab und die Inline-Bearbeitung manuell gegen die Regel.

Wie ordnen Sie System.Drawing.Printing-Einstellungen IronPrint zu?

Eine Anfrage zur Verwendung von IronPrint gibt nicht an, welche IronPrint-Einstellung jede PrintDocument-Einstellung ersetzt. Die folgende Tabelle zeigt diese Zuordnung.

System.Drawing.PrintingIronPrint
PrinterSettings.PrinterNamePrintSettings.PrinterName
PageSettings.PaperSize, in Hundertstel Zoll angegebenDas PaperSize Enum, wie z.B. PaperSize.A4
PageSettings.LandscapePaperOrientation.Landscape oder PaperOrientation.Portrait
PageSettings.Margins, Hundertstel Zoll, links, rechts, oben, untenPaperMargins mit einem Margins Wert, ganze Millimeter, links, oben, rechts, unten
PrinterSettings.CopiesNumberOfCopies
PageSettings.Color auf false gesetztGrayscale auf true gesetzt
PrintDocument.Print mit einem PrintPage HandlerPrinter.Print mit einem Dateipfad und den Einstellungen

Ein konfigurierter Rand von 50 entspricht 12,7 Millimetern, was auf 13 gerundet wird, da der Konstruktor ganze Zahlen benötigt. Der Leitfaden zur Papiergröße von IronPrint listet die Vier-Wert-Reihenfolge als oben, rechts, unten, links auf, während die mitgelieferte XML-Dokumentation und eine Untersuchung der Bibliothek beide links, oben, rechts, unten angeben.

Wie planen und führen Sie eine Migration zu IronPrint durch?

Shift+Tab wechselt den Modus des Chats. Halten Sie bei Plan-Modus an und senden Sie die untenstehende Anfrage. Cursor speichert den Plan in einer Markdown-Datei, die vor der Genehmigung bearbeitet werden kann.

@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.
Text

Bearbeiten Sie den Plan dort, wo er falsch ist. Um ihn zu genehmigen, klicken Sie auf Build, oder kehren Sie in den Agentenmodus zurück und senden Sie diese Anfrage.

@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.
Text

Die @ironprint-despatch Erwähnung fügt der Anfrage die Regel mit Namen hinzu. Der Auftragsbericht druckt die Einstellungen jedes Dokuments ohne einen Auftrag zu senden, sodass der Vergleich auf einem Rechner ohne angeschlossenen Drucker funktioniert.

Welches Cursor-Feature passt zu jeder Änderung?

Wählen Sie das Feature nach der Größe der Änderung aus. Tab bietet den Rest einer bereits im Gange befindlichen Bearbeitung an. Die Inline-Bearbeitung (Ctrl+K) ändert den ausgewählten Code mit einer einzeiligen Anweisung. Agent eignet sich für eine Änderung, die mehrere Dateien umfasst oder einen Build benötigt. Plan-Modus ist den zusätzlichen Schritt wert, wenn das Rückgängigmachen einer falschen Änderung länger dauert als das Schreiben eines Plans, und ein Cloud-Agent verarbeitet unbeaufsichtigte Arbeit.

Wählen Sie die Print-Methode von DespatchJobs aus und fügen Sie sie dem Chat als Kontext mit Strg+Shift+L oder Cmd+Shift+L auf macOS hinzu. Senden Sie dann diese Anfrage aus dem Agentenmodus.

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"`
Text

Der zweite Befehl unterscheidet sich vom installierten Druckernamen nur in der Groß-/Kleinschreibung.

Was passiert, wenn IronPrint den Druckernamen nicht findet?

Der alte Dienst wurde mit einem Fehler gestoppt. System.Drawing.Printing warf eine InvalidPrinterException mit der Nachricht "Einstellungen zum Zugriff auf Drucker 'Despatch-A4-01' sind nicht gültig." IronPrint 2026.10.1 adressierte den erfassten Auftrag für diesen Namen und für drei andere Namen an den Standarddrucker. Dies waren der Beispiel-Druckername aus dem IronPrint-Margen-Leitfaden, ein installierter Drucker in Kleinbuchstaben und derselbe Drucker mit einem angehängten Leerzeichen.

Microsoft Print to PDF, der Standarddrucker der Testmaschine, verlangt einen Dateinamen, sodass ein unbeaufsichtigter Dienst an einem Speichern-unter-Dialog gestoppt hätte. Der Druckernamen-Leitfaden gibt an, dass jeder zurückgegebene Name genau dem Namen in den Windows-Druckereinstellungen entspricht, was einen ordinalen Vergleich mit Printer.GetPrinterNames zur Kontrolle vor jedem Auftrag macht.

Wie debuggen Sie zwei Druckpfade, die nicht übereinstimmen?

Der Reprint-Kioskcode verwendete bereits IronPrint, und sein Einstellungsbericht weicht bei jeder Zeile vom freigegebenen Bericht ab.

@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.
Text

Die Meinungsverschiedenheit hat zwei Ursachen. Der Kioskcode übergibt die Hundertstel direkt an den Zwei-Wert-Konstruktor, sodass ein Lieferschein Randmaße von 50 Millimetern angibt, und die Rücksendung notiert ihren oberen Wert erneut am unteren Rand, wo die Konfiguration 80 Hundertstel setzt. Er legt außerdem für jedes Dokument Hochformat-Ausrichtung fest, da er für Regaletiketten geschrieben wurde.

Ausgabe

In einer Erfassung aus dem Lauf vor der Korrektur wurde der Hochformat-Lieferschein mit Querformat-Ausrichtung auf einem 297 x 210 Millimeter großen Blatt ausgelegt. Seine Seite wurde auf 148,4 x 209,9 Millimeter skaliert, und die anderen 148,5 Millimeter des Blattes blieben leer.

Lieferschein mit den Einstellungen des nicht korrigierten ReprintService, wie IronPrint den Auftrag erstellte, erfasst in einer Datei anstelle eines Druckers.

Was sendet IronPrint an den Drucker?

Keiner der vier Drucker auf der Testmaschine schließt einen Auftrag unbeaufsichtigt ab, sodass nichts auf Papier gedruckt wurde. Für diese Messungen liefen die Beispiele des Margen-Leitfadens und der migrierte Dienst unverändert, und nur der endgültige Aufruf zum Drucken in Windows wurde ersetzt. Bei diesem Aufruf speicherte ein Patch die Seiten und das Druckticket jedes Auftrags als XPS-Datei, und die Druckwarteschlange erhielt nichts. Die unten stehenden Messungen stammen aus diesen Dateien und beschreiben, was ein Drucker erhalten würde.

  • Ränder: Ränder von 0, 10, 15, 20, 30 und 50 Millimetern erzeugten identische Seiten, wobei das Seitenbild das Blatt ausfüllte. Die System.Drawing.Printing-Version des Lieferscheins zeichnete ihr Bild in 12,7-Millimeter-Ränder.
  • Graustufen: Bei einer PNG-Seite änderte die Einstellung nur das Druckticket und das Bild blieb in Farbe. Bei einer PDF-Seite war das Bild selbst grau.
  • Auflösung: Ein PDF wurde mit der Dpi Einstellung gerendert, 2479 x 3508 Pixel für A4 bei 300. Ein PNG wurde in seiner eigenen Pixelgröße gesendet.

Bis IronPrint PaperMargins auf die Seite in Windows anwendet, muss ein Layout, das weißen Raum an den Rändern benötigt, diesen im Dokument selbst mitführen.

Eingabe

Der Dienst druckt drei PNG-Dateien aus TestData/jobs, slip-1001.png, labels-aisle-07.png und return-2207.png. Jedes ist ein 150 DPI-Bild mit einem roten Rand an seinen Kanten.

Packing slip 1001 input image, A4 portrait with a red border Shelf labels for aisle 07 input image, A4 landscape with a red border Returns note 2207 input image, A5 portrait with a red border

Ausgabe

Die unten stehenden PDFs zeigen jeweils einen Auftrag aus dem von Cursor geschriebenen Code. Jedes Seitenbild ist unverändert und behält die Größe der erfassten Seite bei.

Lieferschein, wie IronPrint den Auftrag erstellte, erfasst in einer Datei anstelle eines Druckers. Der Auftrag enthält eine A4-Hochformat-Seite, und sein Druckticket fordert zwei Kopien im Monochrom an.

Regaletiketten, wie IronPrint den Auftrag erstellte, erfasst in einer Datei anstelle eines Druckers. Diese A4-Querformat-Seite misst 297 x 210 Millimeter, und das Druckticket gibt Farbausgabe an.

Rücksendewarnung, wie IronPrint den Auftrag erstellte, erfasst in einer Datei anstelle eines Druckers. Seine einzelne A5-Hochformat-Seite misst 148 x 210 Millimeter, und im Druckticket ist Monochrom-Ausgabe eingestellt.

Wie schreiben Sie Regressionstests für Druckcode?

Cursors Cloud-Agents laufen auf Ubuntu-Maschinen, und das Beispiel zielt auf net9.0-windows ab. Senden Sie diese Anfrage daher in einem lokalen Agenten-Chat.

@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.
Text

Die Ablehnungstests verwenden Druckernamen, die nicht installiert sind, und stoppen daher bei der Druckerprüfung, bevor Printer.Print aufgerufen wird.

Der Leitfaden für KI-Programmierassistenten übernimmt eine IronPrint-Aufgabe von einem leeren Ordner zu einem Ergebnis, das gegen geschriebene Erfolgskriterien geprüft wird.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Cursor erhielt die sieben Eingabeaufforderungen in der angegebenen Reihenfolge gegen das Versand-Beispiel-Repository. Nach dem Lauf wiederholten frische Release-Builds jedes Commits, das den Code änderte, jede der untenstehenden Berichte und Befehle.

  • Vor und nach dem Umstieg auf IronPrint stimmte der Auftragsbericht mit allen 3 Zeilen des freigegebenen Berichts überein.
  • Der Nachdruckbericht stimmte vor der Korrektur mit 0 von 3 Zeilen überein und nach der Korrektur mit 3 von 3.
  • Der Drucker-Befehl listete die vier installierten Drucker mit ihren Fächern auf und markierte beide konfigurierten Drucker als nicht installiert.
  • Jede der fünf Dokumentationsantworten von Cursor zitierte eine Seite, und keine Datei wurde geändert.
  • Bei einem Namen, den GetPrinterNames nicht zurückgibt, wiederholte Cursor die Aussage des Leitfadens und bemerkte, dass die Projektrichtlinie ein anderes Ergebnis beschreibt.
  • Der Plan fand keinen Ersatz für PrintSettings für den Dokumentnamen und notierte dies als Annahme.
  • Nach dem Umstieg referenzierte die App nur noch das IronPrint-Paket, und kein System.Drawing.Printing Code verblieb.
  • DespatchJobs behielt seine öffentlichen Beschreibungs- und Drucksignaturen.
  • Der Druckbefehl lehnte den konfigurierten Drucker für alle drei Dokumenttypen mit Exit-Code 2 und einer Liste der vier installierten Drucker ab.
  • Die Druckerprüfung lehnte auch den installierten Adobe PDF-Drucker ab, der in Kleinbuchstaben getippt oder mit einem abschließenden Leerzeichen versehen war.
  • Vor seiner Korrektur sandte der Nachdruckbefehl Aufträge für einen fehlenden konfigurierten Drucker und für "adobe pdf" an den Standarddrucker.
  • Nach der Korrektur lehnte der Nachdruckbefehl beide Namen ab. Es stoppte mit einer unbehandelten Ausnahme, da Eingabe 06 keinen Exit-Code anforderte.
  • Alle 9 xUnit-Tests bestanden. Sie kamen aus fünf Testmethoden, und keiner sandte einen Auftrag.
  • Der Lauf ließ die Konfiguration, die Testdaten und die Projektrichtlinie unverändert.
  • Jedes Release-Build beendete mit 0 Warnungen und 0 Fehlern, und keine Datei wurde manuell bearbeitet.
  • Einige Schritte liefen anders als die Seite. Jede Eingabeaufforderung wurde manuell in einem lokalen Desktop-Chat gesendet. Eingabeaufforderung 04 wurde zuerst eingefügt, ohne gesendet zu werden, und wurde gesendet, nachdem das Protokollierungsskript des Laufs meldete, dass sie im Chat fehlte. Der Plan wurde genehmigt, indem Eingabeaufforderung 04 in Agent gesendet wurde, und Build wurde nie angeklickt. Cursors Migration überprüfte bereits den Druckernamen, wie der Plan vorschlug, also änderte Eingabeaufforderung 05 eine bestehende Prüfung.

Der GitHub Copilot-Leitfaden hält auch pfadspezifische Anleitungsdateien im Repository, und der Google Antigravity-Leitfaden testet die Druckseite in einem echten Browser. Das Laufprotokoll listet die Werkzeugversion, das Modell, die Dauer und die Testmaschine für jeden Leitfaden auf.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 52,106Version:2026.11gerade veröffentlicht