C#でプリンター名を指定する方法

入力

invoice.pdf は、明細項目と合計金額を含む、書式設定済みの A4 サイズの B2B 請求書であり、PrintSettings.PrinterName を通じて特定の名前付きプリンターに印刷されます。

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-set-printer-name.cs

using IronPrint;

// Configure print settings with a target printer
PrintSettings settings = new PrintSettings();
settings.PrinterName = "Microsoft Print to PDF";

// Print to the specified printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with a target printer
Dim settings As New PrintSettings()
settings.PrinterName = "Microsoft Print to PDF"

' Print to the specified printer
Printer.Print("invoice.pdf", settings)

まず、PrinterName = nullで初期化されます。 その後、PrinterName を対象プリンターの正確な文字列名で上書きします。 Printer.Printを呼び出すと、IronPrintはそのジョブをそのプリンターのキューに直接送信します。

出力

請求書は名前指定されたプリンターに直接送られます。 ジョブはサイレント印刷の例と同様にプリンターキューに表示されます。

"Microsoft Print to PDF"を使用してPrinterNameに請求書出力が印刷されました。

考慮すべき2つの詳細があります。 最初に、プリンター名はオペレーティングシステムが報告する名前と正確に一致しなければなりません; この比較は大文字と小文字を区別します。"hp laserjet" ではなく "HP LaserJet" といった不一致がある場合、エラーは発生せず処理が失敗するか、エラーがスローされます。 第二に、ユーザーが ShowPrintDialog を通じてPRINTダイアログを開いた場合、そのダイアログでの選択内容がコード内で設定された PrinterName を上書きし、ユーザーに最終的な決定権が与えられます。

プリンター名が事前に知られていない場合、値をハードコードする代わりに、ランタイムでインストールされているすべてのプリンターを照会できます。

入力

report.pdfはA4のビジネスレポートで、要約セクションとデータテーブルが含まれ、最初に動的に発見されたプリンターで印刷されます。

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-discover-printers.cs

using IronPrint;

// List every installed printer
List<string> printers = Printer.GetPrinterNames();

// Print each printer name
foreach (string name in printers)
{
    Console.WriteLine(name);
}

// Print to the first available printer
if (printers.Count > 0)
{
    Printer.Print("report.pdf", new PrintSettings
    {
        PrinterName = printers[0]
    });
}

Imports IronPrint

' List every installed printer
Dim printers As List(Of String) = Printer.GetPrinterNames()

' Print each printer name
For Each name As String In printers
    Console.WriteLine(name)
Next

' Print to the first available printer
If printers.Count > 0 Then
    Printer.Print("report.pdf", New PrintSettings With {
        .PrinterName = printers(0)
    })
End If

GetPrinterNames を呼び出すことで、ローカルプリンター、ネットワークプリンター、"Microsoft Print to PDF"のような仮想プリンターを含め、オペレーティングシステムが認識しているすべてのプリンターを取得します。その後、リストを順に処理し、インデックス、名前の照合、またはアプリケーションが必要とする任意のカスタムロジックに基づいてプリンターを選択します。

出力

レポートは最初に利用可能なプリンターに送信されます。 上記のようにジョブはプリンターキューに表示されます。

GetPrinterNamesを介して最初に使用可能なプリンターにレポート出力が印刷されました。

この発見してから印刷するパターンは、異なるマシンに配備されたアプリケーションにとって必要不可欠です。 シングルマシンシナリオではプリンター名のハードコーディングが機能しますが、プロダクションアプリケーションは利用可能なプリンターをクエリし、ユーザーに選択させるか、命名規則に基づいてプログラムでプリンターを選択する必要があります。

プリンターの選択は、用紙サイズ、DPI、コピー数、余白と組み合わせて1つの設定オブジェクトにすることもできます。

入力

quarterly-report.pdf は、KPIカードやチャートを含むA4サイズの四半期財務報告書であり、用紙サイズ、DPI、部数を1つの PrintSettings オブジェクトにまとめて PrinterName で印刷されます。

:path=/static-assets/print/content-code-examples/how-to/specify-printer-name/specify-printer-name-combined-settings.cs

using IronPrint;

// Configure full print settings with a named printer
PrintSettings settings = new PrintSettings
{
    PrinterName = "Office Color Printer",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Configure full print settings with a named printer
Dim settings As New PrintSettings With {
    .PrinterName = "Office Color Printer",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the quarterly report
Printer.Print("quarterly-report.pdf", settings)

読みやすいようにオブジェクト初期化子構文を使用します。 PrinterName はジョブを"Office Color Printer"にルーティングし、残りのプロパティは出力形式を制御します。 Dpi を300で設定すると、鮮明なテキストとグラフィックが得られます。 PaperMargins は、Margins コンストラクタを通じてミリメートル単位の値を受け付けます。 利用可能なプロパティの全リストは、印刷設定ガイドを参照してください。

出力

四半期レポートは、名前付きプリンター、A4縦向き、300 DPI、2部、15 mmの余白で1つのジョブとして印刷されます。 上記のようにジョブはプリンターキューに表示されます。

四半期レポート出力がPrinterName、A4、300 DPI、2部、15mmの余白と共に印刷されました。

IronPrintは構成を1つのユニットとして検証し、統合設定を単一のジョブとしてプリンタードライバーに送信します。

プリンターの発見または印刷中にメインスレッドをブロックできないアプリケーションは、両操作の非同期相当を使用できます。

出力

請求書は非同期で最初に発見されたプリンターに印刷されます。 上記のようにジョブはプリンターキューに表示されます。

請求書出力が非同期で最初に利用可能なプリンターに印刷されました。

本番環境では、printers[0] を、命名規則に合致するロジック（例：配送ラベル用には"Label"を含むプリンター、ブランド文書用には"Color"を含むプリンターを検索するなど）に置き換える場合があります。 IronPrintの非同期メソッドはすべて同じPrinterNameの動作は同期パスと非同期パスで同一です。

静的割り当て、ランタイム発見、設定の組み合わせ、および非同期ワークフローのすべてをカバーしたので、関連するリソースのいくつかをブックマークする価値があります。