如何使用 IronPrint 在 C# 中配置打印設置。

使用 IronPrint 的 PrintSettings 類在 C# 中配置列印設定，以控制紙張大小、方向、DPI、邊界等。 只需實體化 PrintSettings、設定您的偏好設定，並將其傳給 Print 方法即可。

<！--說明：說明程式碼概念的圖表或截圖 -->

快速入門：使用 IronPrint 設定進行設定和列印

透過建立 PrintSettings 物件開始，設定紙張大小、方向、DPI、複本和灰階等屬性。 然後呼叫Printer.Print(...)即可立即套用這些設定－無需複雜的設定。

如何設定列印設定？ <！--說明：說明程式碼概念的圖表或截圖 --> 若要設定列印設定，請實體化 [PrintSettings class](https://ironsoftware.com/csharp/print/features/settings/) 並根據您的喜好進行設定。 在 `Print` 或 `ShowPrintDialog` 方法中，傳入 `PrintSettings` 物件作為第二參數。 下面的程式碼範例說明了這種用法。 如需更詳細的範例，請查看 [列印設定程式碼範例](https://ironsoftware.com/csharp/print/examples/print-settings/)頁面。 ```csharp // Import the necessary namespace for IronPrint using IronPrint; // Initialize a new instance of the PrintSettings class PrintSettings settings = new PrintSettings(); // Configure various print settings settings.PaperSize = PaperSize.A4; // Set paper size to A4 settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape settings.Dpi = 300; // Set print resolution to 300 DPI settings.NumberOfCopies = 2; // Set the number of copies to 2 settings.PrinterName = "MyPrinter"; // Set the name of the printer settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side settings.Grayscale = true; // Print in grayscale // Use the PrintSettings in the Print method IronPrint.Printer.Print(document, settings); ```

為什麼我需要設定列印設定？ 列印設定是指決定如何列印文件或內容的配置或參數集。 這些設定包括紙張大小、方向（直印或橫印）、列印解析度（每英吋點數 - DPI）、列印份數、印表機選擇、邊界以及灰階列印等選項等細節。 自訂這些設定，以達到特定的列印偏好與要求。 IronPrint 全面的[列印設定功能](https://ironsoftware.com/csharp/print/features/settings/)可讓開發人員精細控制列印流程的每個面向。 無論是建立桌面應用程式或 [ASP.NET Web 應用程式](https://ironsoftware.com/csharp/print/how-to/aspnet-web-application-framework/)，適當的配置都能確保在不同環境下得到一致的結果。

何時應該使用自訂列印設定？ 當需要精確控制列印輸出時，自訂列印設定是不可或缺的，例如列印具有特定邊距的報告、產生多份文件，或確保文件以正確方向列印以符合業務需求。 以下是列印有特定要求的發票的實用範例： ```csharp // Example: Printing invoices with business requirements using IronPrint; // Invoice printing with specific business settings var invoiceSettings = new PrintSettings { PaperSize = PaperSize.Letter, // US Letter size for business documents PaperOrientation = PaperOrientation.Portrait, Dpi = 600, // High quality for professional output NumberOfCopies = 3, // Original + customer copy + file copy PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer Grayscale = false, // Keep company logo in color PrinterName = "Office Color Printer" // Specific high-quality printer }; // Print the invoice Printer.Print("invoice_2024_001.pdf", invoiceSettings); ```

如果我沒有指定列印設定會如何？ 如果沒有指定列印設定，IronPrint 會使用系統預設印表機的預設設定，這可能與您的預期輸出格式或品質要求不符。 若要發現系統上可用的印表機，請使用 [GetPrinterNames 方法](https://ironsoftware.com/csharp/print/examples/get-printer-names/) 以程式化的方式擷取所有連接的印表機。

有哪些列印設定可用？ <！--說明：螢幕截圖或圖表 --> 探索以下所有可用的列印設定選項。 完整的 [API 參考](https://ironsoftware.com/csharp/print/object-reference/api/)為每個屬性和方法提供詳細的說明文件： |設定|說明|預設值|備註| |---------|-------------|---------------|---------| |**預設設定**|以預設值初始化 IronPrint.PrintSettings 類的新實例| 不適用 | 不適用 | |**紙張大小**|設定印表機使用的紙張尺寸| IronPrint.PaperSize.PrinterDefault | 不適用 | |**文件方向**|指定紙張方向（例如：直印或橫印）| IronPrint.PaperOrientation.Portrait | 不適用 | |**Dpi**|代表預期的列印解析度（以每英吋點數為單位| 300 |實際用於列印的 DPI 可能會受到印表機功能的限制| |**份數**|表示列印文件時產生的相同複本數量| 1 |在某些平台中，可能存在無法精確複製多份的限制。 在這種情況下，`IronPrint.PrintSettings.NumberOfCopies` 的指定值可能會被忽略，導致只列印一份。| |**印表機名稱**|指定用於列印的印表機名稱|空（使用作業系統預設印表機）|如果您在 PrintDialog 中選擇印表機，此設定將會被忽略。 若要取得可用的印表機名稱，您可以使用 `IronPrint.Printer.GetPrinterNames` 或 `IronPrint.Printer.GetPrinterNamesAsync` 取得印表機名稱清單| |**紙邊距**|以毫米為單位設定列印時使用的邊距|空（使用印表機預設邊距）| 不適用 | |**灰階**|表示是否以灰階列印|錯誤| 不適用 | |**扁平化**。|在列印前將 PDF 壓平，這對於顯示表格欄位值和圖片非常有用|虛假| 不適用 | |**托盤**|用於列印工作的印表機托架。 這可讓使用者指定特定的紙盤，從該紙盤將紙張送入印表機|空（使用印表機預設托盤）|如果您在 PrintDialog 中選擇托盤，此設定將會被忽略。 若要取得可用紙盒，可以使用`IronPrint.Printer.GetPrinterTrays(System.String)`或`IronPrint.Printer.GetPrinterTraysAsync(System.String)` 。 此托盤選擇屬性僅適用於 Windows|

哪些列印設定應該經常設定？ 對於大多數的商業應用程式，請務必設定 `PaperSize`, `PaperOrientation`, 和 `Dpi` 以確保不同印表機和系統的輸出一致。 這三種設定對文件的外觀和可讀性影響最大。 在使用基於對話方塊的列印時，請使用 [ShowPrintDialog 方法](https://ironsoftware.com/csharp/print/examples/print-with-dialog/)，將自訂設定與使用者互動結合： ```csharp // Pre-configure settings but allow user to modify var presetSettings = new PrintSettings { PaperSize = PaperSize.A4, PaperOrientation = PaperOrientation.Portrait, Dpi = 300 }; // Show dialog with preset values Printer.ShowPrintDialog("report.pdf", presetSettings); ```

如何處理特定平台的設定？ 某些設定（如托盤選擇）僅在 Windows 上可用。 使用特定平台功能時，務必檢查平台相容性，並為跨平台應用程式提供備用行為。 有關特定平台問題的疑難排解，請參閱 [工程支援指南](https://ironsoftware.com/csharp/print/troubleshooting/engineering-request-print/)。

常見的列印設定組合有哪些？ 常見的組合包括用於標準文件的 A4/Portrait/300 DPI、用於詳細報告的 A3/Landscape/600 DPI，以及用於草稿列印以節省油墨的 Letter/Portrait/300 DPI/Grayscale。 以下是一個展示不同情境的範例： ```csharp // Standard office document var standardDocument = new PrintSettings { PaperSize = PaperSize.A4, PaperOrientation = PaperOrientation.Portrait, Dpi = 300 }; // Detailed engineering drawing var technicalDrawing = new PrintSettings { PaperSize = PaperSize.A3, PaperOrientation = PaperOrientation.Landscape, Dpi = 600, Grayscale = false }; // Draft mode for review var draftMode = new PrintSettings { PaperSize = PaperSize.Letter, PaperOrientation = PaperOrientation.Portrait, Dpi = 150, Grayscale = true, NumberOfCopies = 5 }; // High-volume batch printing var batchPrint = new PrintSettings { PaperSize = PaperSize.A4, PaperOrientation = PaperOrientation.Portrait, Dpi = 300, NumberOfCopies = 100, Tray = "Tray 2" // Large capacity tray on Windows }; ``` 如需更全面的範例和進階列印情境，請探索 [ 列印文件教學](https://ironsoftware.com/csharp/print/tutorials/print-document/)，其中涵蓋從頭到尾的完整列印工作流程。 在生產環境中實施列印設定時，尤其是在使用 Web.config 的 Web 應用程式中，請檢閱 [ 在 Web.config 中設定授權金鑰的指南](https://ironsoftware.com/csharp/print/troubleshooting/license-key-web.config/)，以確保配置正確。