AIコーディングアシスタントとIronPrintの使い方

Curtis Chau
Curtis Chau
更新日: 2026年10月26日

IronPrintは、.NET向けIron Softwareの印刷ライブラリです。 C#コードからPDFファイルと画像をプリンターに送信し、Windows、macOS、iOS、Androidでサイレントモードまたはシステム印刷ダイアログを通じて印刷します。

印刷は多くのドキュメント機能の最後のステップであり、出力が機械外に出るためテストが難しいです。IronPrintのドキュメントがなければ、アシスタントはどのメンバーが存在するか判断できません。最初のリクエストの前にドキュメントを提供してください。

すべてのアシスタントには同じ4つのステップが必要です。 パッケージを追加し、環境からキーを読み取り、アシスタントにIronPrintの機械可読ドキュメントを提供し、タスクを閉じる前に各ジョブの内容を確認してください。 同じステップでサイレント印刷、名前でプリンターを選択、印刷設定、およびダイアログ印刷をカバーできます。

Claude Code AI コーディングアシスタントのロゴChatGPT Codex AI コーディングアシスタントのロゴGitHub Copilot AIコーディングアシスタントロゴCursor AIコードエディターロゴGoogle Antigravity AIコーディングエージェントロゴ

AIアシスタントは独自に印刷を扱えないのか?

サイレント印刷ガイドはSystem.Drawing.Printingルートをすべてのドキュメントタイプのページイベントハンドラーを持つPrintDocumentとして説明しており、組み込みのPDFレンダリング機能はありません。

IronPrintのAPIは2つのクラスPrinterおよびPrintSettingsを中心に据え、ステップ3でそれらを説明する機械可読ドキュメントを列挙します。

最初の印刷呼び出しを書く前に3つのポイントを適用します。

  • 即興の印刷コードはトークンを費やす:生のSystem.Drawing.Printing呼び出しから欠けている設定を構築する各試みはトークンを消費し、そのコードはmacOSでTypeInitializationExceptionを投げます。
  • パッケージ名は重要です: NuGetパッケージと名前空間は両方ともIronPrintです。 スロップスクワッティングは、言語モデルが実在しないパッケージ用に生成するパッケージ名の登録ですので、プロンプトは正確にパッケージを命名しなければなりません。
  • ライセンスには更新料金がありません: IronPrintライセンスは永続ライセンスです。 ライセンスページの各ティアはそれぞれ独自の開発者、場所、プロジェクト許容値を設定します。

ステップ1: IronPrintをインストールする

アシスタントにパッケージを追加させ、解決したバージョンを名前を挙げてください。

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

.NET CLIコマンドは同じリリースをピン留めします。

dotnet add package IronPrint --version 2026.10.1
SHELL

ターゲットフレームワークはパッケージが使用する印刷パスを決定します。 net9.0-windowsビルドはIronPrintのWPF印刷パスをロードし、Windows上での単なるnet9.0ビルドはSystem.Drawing.Printingに基づいたパスをロードします。 2つのパスは同じプリンターに対して異なるトレイ名を報告します。 Adobe PDFの場合、WPFパスはAuto Selectを返し、単なるビルドはAutomatically SelectとOnly Oneを返しました。 macOSはnet9.0-macosまたはnet9.0-maccatalystターゲットの一致するワークロードが必要で、Linuxはサポートされていない印刷プラットフォームです。


ステップ 2: ライセンス キーを適用する

キーがなくてもプログラムはプリンターとそのトレイをリストできますが、PrintAsyncはジョブが作成される前にメッセージProduction License RequiredとともにIronSoftware.Exceptions.LicensingExceptionを投げます。 Printは同じ例外をSystem.AggregateExceptionでラップして投げます。 無効なキーがある場合、メッセージはLicense Key Not Recognizedになります。 そのため、ライセンスのないプログラムは出力を全く生成しません。透かし入りでもなく。以下のフォームは無料試用キーを発行します。

無料トライアルで今日からプロジェクトにIronPrintを使用し始めましょう。

初めの一歩:
arrow pointer

アプリケーションが開始した際に、最初のIronPrint呼び出しの前にキーを1度設定します。 キーは環境変数から取得されるため、コミットに含まれません。

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

一度有効なキーが割り当てられると、IronPrint.License.IsLicensedはtrueを返します。 IronPrint.License.IsValidLicenseは任意のキー文字列をテストします。 ライブラリはIRONPRINT_LICENSE_KEYを自分で読み込むことは決してなく、このアーティクルのプローブでは割り当てなしに変数を設定してもIsLicensedはfalseのままでした。

注意してください: IronPrint License KeysはWeb.config、App.config、またはappsettings.jsonでのキー設定についても記載しています。

ステップ3: IronPrintのLLMドキュメントにアシスタントを指示する

  • llms.txtは43ページをそれぞれ一行ずつインデックスします。 すべての新しいセッションに含めてください。
  • llms-full.txtは33のドキュメントページそれぞれの要約を1ファイルに収めています。
  • llms-full-catalog.txtはブログ記事も含めたインデックスです。
  • オブジェクトリファレンスはすべてのメンバーのシグネチャを提供します。
  • スキルファイルを読むツールはskill.mdをロードできます。 そのセクションにはインストール、ライセンス、印刷レシピ、プラットフォーム展開、既知の失敗の修正が含まれています。
  • AI製品仕様書はサポートされているプラットフォームと主な使用ケースを列挙します。

タスクが特定のガイドに依存している場合、アシスタントをそのページに指示します。

インデックスを送信し、その中に留まるよう指示します。

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

疑わしいメンバーについての行は、アシスタントがメンバーを生成するのではなくギャップを報告できるようにします。


ステップ4: プロジェクトにIronPrintコンテキストを追加する

チャットインストラクションはセッションで終了するため、IronPrintルールはツールが各回読み込むプロジェクトファイルに入ります。Claude CodeはCLAUDE.mdを、ChatGPT CodexはAGENTS.mdを、GitHub Copilotファイルは.github/copilot-instructions.mdです。 Cursorは.mdcルールを.cursor/rules/からとAGENTS.mdをロードし、Google AntigravityはAGENTS.mdまたはGEMINI.mdをロードします。 同じテキストは各ファイルで動作し、CursorルールにはMDCのフロントマターが追加されます。 このブロックから始めます。

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

スキルファイルの単一ファイル例は2026.8.1バージョンのIronPrintをピン留めしており、ここでテストされた2026.10.1パッケージより2リリース古いです。


ステップ5: ワンショットセットアッププロンプト

このプロンプトはステップ1から4を一つのメッセージにまとめて、プロジェクトまたはセッション開始時に送信します。

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
ヒント: その後、ステップ4プロジェクトファイルを確認し、ルールが記述されたことを確認してください。

ステップ6: 作業コードを生成するプロンプトパターン

プリンター名がどこから来るのか、どのファイルタイプが印刷されるのか、すべての印刷設定を述べてください。

あいまい 請求書をIronPrintで印刷してください。

より良い プリンター名を設定から取り、Printer.GetPrinterNamesに表示されることを確認し、invoice.pdfをPrintSettingsをA4、自動方向、グレースケール、2部に設定して印刷します。

IronPrintリリース名とコードが対象とするターゲットフレームワークを命名してください。

より良い IronPrint 2026.10.1をnet9.0-windows上で使用し、最初のジョブの前にIronPrint_LICENSE_KEYからキーを割り当てます。

全体のファイルを要求してください。 フラグメントはusing IronPrint;ディレクティブとキーを割り当てる行を省略可能です。

より良い Program.cs全体を、すべてのusingディレクティブとライセンス割り当てを含めて返送し、編集せずにビルドできるようにします。


ステップ7: 戻ってきたものを確認する

2026.10.1でのプローブは、以下の各誤りの背後にある挙動の測定を行いました。

  • 未検証のプリンター名:インストールされていないプリンターに一致する名前はエラーを起こしません。 テストでは、PrintAsyncは例外を発生させず、ジョブはデフォルトプリンター、Microsoft Print to PDFへ送られ、人がそのNameを入力するまで保持されました。 受け入れるのはPrinter.GetPrinterNamesが返した名前だけです。
  • UIスレッド上でのPrint:同期呼び出しは、それを呼び出したスレッドをブロックし、WPFとWinFormsのインターフェイスをフリーズさせます。ハングアップのトラブルシューティングページが説明しています。 PrintAsyncを使います。
  • プロンプトが必要なテストプリンター:Microsoft Print to PDFに送られた2つのジョブは、ファイル名を入力した後にのみ完了しました。 無人のテストには、自動で完了するプリンターか、次のセクションでのキャプチャ方法が必要です。
  • 無地のターゲットでのShowPrintDialog:トラブルシューティングページは、この呼び出しは無地の.NETターゲットでAggregateExceptionを発生させる可能性があると言っています。 Windows上で、通常のnet9.0ビルドは投げませんでした。 呼び出しは実際の印刷ダイアログを開き、ダイアログが閉じた後に初めて戻り、10.1秒後に終了しました。 無人コードからダイアログ呼び出しを除外します。

エージェントに自身の作業を検証させる

アシスタントにこれらのチェックを実行し、証拠を報告させます。

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

IronPrintでのサイレント印刷ジョブ

Windowsでは、IronPrint 2026.10.1はジョブをWPFの印刷ダイアログクラスに設定を保持する印刷チケットで渡し、表示しません。 テストパッチはその呼び出しをインターセプトし、XPSファイルとして各ジョブを保存しました。それにより、このセクションの数値は紙を使わずに測定されました。

  • 各PDFページはDpi設定で画像にレンダリングされます。 以下の実行ではA4ページが150 DPIで1240 x 1753ピクセルの画像になり、私たちのプローブでは300 DPIで2479 x 3508ピクセルの画像になりました。
  • PaperSize.A4は210 x 297 mmのページを生成し、PaperSize.Letterは215.9 x 279.4 mmのページを生成しました。
  • PaperOrientation.Automaticで、横向きページは横向きページとして印刷されました。 Portraitでは、同じページが肖像シートに合わせて縮小され、上部のみを埋めました。
  • カラーページはGrayscaleがオンであるときにグレイ画像として到着しました。 PNG内の赤いテキストは赤のままで、印刷チケットのみがそれにモノクロ出力を要求しました。
  • NumberOfCopiesはチケットのコピー数を設定し、ジョブはまだ1セットのページを保持しました。

印刷設定ガイドはプリンターがDPIを制限でき、一部のプラットフォームはコピー数を無視することを述べていますので、両方の値はドライバーへの要求です。


IronPrintでのファイル形式

2026.10.1で、PDF、PNG、JPG、BMP、TIFFファイルが印刷されます。 サイレント印刷ガイドは両方の形式をリストしていますが、GIFとHTMLファイルはジョブが作成される前にSystem.IO.InvalidDataExceptionをメッセージUnsupported file typeで投げます。 スキルファイルは動作する5つの形式をリストします。 HTMLは最初にPDFにレンダリングしてください。例えば、IronPDFで。

画像は1ページとして印刷され、ページ幅にスケーリングされます。 1200 x 800ピクセルのPNGは、Automaticの方向で横向きのA4ページに印刷され、Portraitで肖像ページの上部に印刷されました。


再現可能な結果

テストは単一のプロンプトで、すべてのコードはアシスタントから提供されます。 空のフォルダを作成し、その中で新しいセッションを開き、プロンプトを貼り付け、結果をWhat Passesの下のリストと照らし合わせて確認してください。

注意してください: 必要なものはWindows、.NET 9 SDK、ターミナルコマンドを実行するアシスタント、NuGetおよびドキュメントへのネットワークアクセス、IRONPRINT_LICENSE_KEYにIronPrintトライアルまたはプロダクションキー、PRINTER_NAMEにインストールされたプリンタの名前です。 プロンプトはすべてのジョブをXPSファイルにキャプチャするため、プリンタには何も送られません。

プロンプト

アプリが独自のテストセットを書くので、テスト実行からの6つのファイルは以下に印刷順で結合されています。 その4つのPDFには変更がなく、PNGとGIFはそれぞれのピクセルサイズで独自のページに表示されます。

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

出力

実行の未編集実行記録は6つのファイルそれぞれの測定値を示しています。

キャプチャが書き込んだすべてのページは以下のPDFにあります、印刷順で。

バッチ出力はIronPrintがジョブを構築したとおりにキャプチャし、プリンターの代わりにXPSファイルにし、編集なしでページごとにPDFに変換されました。

  • net9.0-windows リリースビルドは警告0、エラー0を報告しました。
  • パッチのセルフテストはnullページャーで合格し、ファイルを書き込まなかった。
  • 6つのジョブのうち5つはキャプチャされ、合計7ページありました。
  • 3つの肖像PDFはそれぞれのソースページに対する210 x 297 mmのページになりました。
  • 横向きのPDFとPNGは297 x 210 mmの横向きページになりました。
  • すべてのチケットにはA4用紙、1部、モノクロ出力、150 x 150 DPIが指定されていました。
  • GIFはサポートされていないファイルタイプエラーとして失敗として記録されました。
  • No Such Printer 12345での実行は、ジョブとキャプチャフォルダを変更せずにそのまま止まりました。
  • XPSファイルを独立して読み込むと、実行記録内の全ての値に一致しました。
  • 承認ビルドの新しい開始が同じ5つのキャプチャを生成しました。
  • プロジェクトフォルダにはライセンスキーのコピーは見つかりませんでした。
  • インストールプロンプトは2026.10.1ピンを保持しました。
  • ドキュメントプロンプトはコードを変更しませんでした。
  • その回答はサイレント印刷ガイドとスキルファイルがGIFおよびHTMLについて異なっていると報告しました。
  • 新しいCLAUDE.mdがセットアッププロンプトのルールと測定された挙動を受信した。
  • セルフチェックは5つすべてのキャプチャされたジョブがリクエストされた設定を持っていたと確認しました。
  • 一部のステップはページと異なる方法で実行されました。 承認プロンプトが最初に実行され、同じセッションでステップ1、3、5、7のプロンプトが続きました。 アプリはPRINTER_NAMEと大文字小文字を問わず一致し、プリンターリストから正確な名前を渡しました。

合格条件

  • リリースビルドは手動でのコード編集なしで成功しました。
  • IsLicensedがfalseであるかまたはPRINTER_NAMEがPrinter.GetPrinterNamesにない場合、アプリはジョブの前に停止します。
  • すべての印刷可能ファイルはXPSキャプチャを持ち、そのページとページサイズ、チケットの値はrunrecord.mdと一致します。自分でXPSファイルを読み込むとよいでしょう。
  • GIFは失敗として記録され、バッチは続行します。
  • ライセンスキーはすべてのプロジェクトファイルから欠如しています。
注意してください: 別のIronPrintリリースについては、プロンプトのステップ1でバージョンを変更し、最初にIronPrintのchangelogを読みます。

実行記録

  • すべての実行は、Core i9-14900KFと64 GBのメモリを備えたWindows 11 x64デスクトップ1台で行われました。
  • どのガイドもジョブを物理的なプリンターに送信しませんでした。
  • このガイドのプロジェクトはnet9.0-windowsをターゲットにし、IronPrint 2026.10.1をピン留めし、キャプチャモードのためのLib.Harmony 2.3.6を持っています。
  • ガイドの期間はそのページのプロンプトのログ時間の合計であり、このガイドの行は受理プロンプトのみを数えます。
  • 表内のバージョンとモデルは、各ツールの独自のセッションファイルと実行ログから来ており、別のバージョンチェックによるものではありません。
  • 最後のテストはこのガイドについて2026年10月15日、Claude Code、ChatGPT Codex、GitHub Copilot(プロンプト1および2のみ)、Google Antigravity、Cursorについて2026年10月16日に行われました。
ガイドアシスタントとバージョンモデル期間(分)
このガイドClaude Code 2.1.277、一つのセッション、許可プロンプトオフClaude Opus 523.7
Claude CodeClaude Code 2.1.277、opusplanエイリアス、プロンプト3はプランモードでClaude Sonnet 5、Claude Opus 5プランニングプロンプト3と16.4
ChatGPT CodexCodex CLI 0.160.0、一度にGPT-6 Luna17.9
GitHub CopilotCopilot CLI 1.0.95、月次クォータによってプロンプト2で停止GPT-6 Luna、Auto選択1.5、プロンプト1および2のみ
CursorCursor 3.23.23デスクトップアプリ、プロンプト3はPlan ModeでGrok 4.7102.8
Google AntigravityAntigravity CLI 1.3.5、プロンプト1中に1.3.6に自動更新され、プロンプト1および5は/planで送信、パーミッションプロンプトはスキップGemini 3.8 Flash(高)61.9

エージェント固有のガイド

各ツールガイドはこれらのステップで1つの印刷タスクを構築します。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 52,106バージョン:2026.11ちょうどリリースされました