1. IronPrint
  2. 操作指南
  3. ASP.NET Web 應用框架

使用 C## 在 ASP.NET Framework Web App 中打印

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPrint 的 PrintAsync 方法可在 ASP.NET 網頁應用程式中實現非阻塞式文件列印，避免在處理列印請求時導致使用者介面凍結。 此異步方法可確保響應式 Web 應用程式能夠在不阻塞線程的情況下處理列印作業。

網路應用程式通常需要文件列印作為最終輸出。 將列印功能整合至網路應用程式會帶來挑戰，尤其是在處理異步作業時。 IronPrint 透過 PrintAsync 函式來解決此問題。 本教學示範如何使用 .NET Core 實作 PrintAsync，以建立一個在不阻塞主程式的情況下列印文件的網頁應用程式。

在實施之前，請注意 IronPrint 提供全面的功能，包括印表機資訊檢索和自訂列印設定。 這些功能使其非常適合需要強大列印功能的企業級 ASP.NET 應用程式。

快速入門：ASP.NET 中的非同步 PDF 列印

  1. 透過 NuGet 安裝 IronPrint：Install-Package IronPrint
  2. 將 IronPrint 匯入控制器檔案
  3. 新增一個列印按鈕以觸發該方法
  4. 在控制器動作中呼叫 await Printer.PrintAsync("file.pdf")
  5. 驗證按下按鈕時的文件列印功能

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPrint

    PM > Install-Package IronPrint

  2. 複製並運行這段程式碼。

    return await IronPrint.Printer.PrintAsync("Basic.pdf");

  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronPrint

    arrow pointer

開始使用 IronPrint

立即開始在您的項目中使用 IronPrint 並免費試用。

第一步：
green arrow pointer

如何在 ASP.NET 網頁應用程式中進行列印

  1. 從 NuGet 安裝 C# 列印函式庫
  2. 將 `IronPrint` 導入控制器
  3. 新增一個列印按鈕以觸發該動作
  4. 在控制器方法中呼叫 `PrintAsync`

如何在 ASP.NET 中實作異步 PDF 列印？

此範例展示如何在 ASP.NET Web Application (.NET Framework) 專案中，使用 PrintAsync 方法以非同步方式列印 PDF 檔案。 PrintAsync 會以非同步方式觸發列印，相較於會阻塞執行緒的同步 Print 方法，能讓應用程式保持響應性。

在多位使用者可能會同時觸發列印作業的網路應用程式中，異步方式至關重要。 與同步的 Print 方法不同，PrintAsync 可確保您的應用程式在不影響效能的情況下處理並發請求。

我應該在哪裡加入列印按鈕？

在您的"Index.cshtml"(或首頁視圖)中，新增一個按鈕，點擊該按鈕將觸發一個操作。 此按鈕會在您的控制器中呼叫 ActionResult 方法：

@{
    ViewBag.Title = "Home Page";
}

<main>
    <section class="row" aria-labelledby="aspnetTitle">
        <h1 id="title">ASP.NET</h1>
        <p>

            <a class="btn btn-primary btn-md" onclick="location.href='@Url.Action("PrintPdf", "Home")'">Print PDF</a>
        </p>
    </section>
</main>
@{
    ViewBag.Title = "Home Page";
}

<main>
    <section class="row" aria-labelledby="aspnetTitle">
        <h1 id="title">ASP.NET</h1>
        <p>

            <a class="btn btn-primary btn-md" onclick="location.href='@Url.Action("PrintPdf", "Home")'">Print PDF</a>
        </p>
    </section>
</main>
HTML

顯示導覽選單及藍色

如何在控制器中配置 PrintAsync？

在您的 HomeController 中，實作 PrintAsync 方法。 此方法以非同步方式執行列印作業，可提升應用程式的反應能力。 在實施之前，請確保有適當的許可金鑰配置以供生產使用。

using IronPrint;
using System.Threading.Tasks;
using System.Web.Mvc;

namespace WebApplication4.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            return View();
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            return View();
        }

        // Action method to handle the printing operation
        // This makes use of the PrintAsync method to avoid blocking the main thread
        public ActionResult PrintPdf()
        {
            // Wait for the asynchronous print operation to complete
            Printer.PrintAsync("Basic.pdf").Wait();

            // Return some view, for example, a confirmation page or the index page
            return View(); // Replace with an appropriate view
        }
    }
}
using IronPrint;
using System.Threading.Tasks;
using System.Web.Mvc;

namespace WebApplication4.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            return View();
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            return View();
        }

        // Action method to handle the printing operation
        // This makes use of the PrintAsync method to avoid blocking the main thread
        public ActionResult PrintPdf()
        {
            // Wait for the asynchronous print operation to complete
            Printer.PrintAsync("Basic.pdf").Wait();

            // Return some view, for example, a confirmation page or the index page
            return View(); // Replace with an appropriate view
        }
    }
}
$vbLabelText   $csharpLabel

針對進階方案，實施適當的 async/await 模式，並自訂列印作業。 以下是示範錯誤處理和自訂列印設定的增強範例：

using IronPrint;
using System;
using System.Threading.Tasks;
using System.Web.Mvc;

namespace WebApplication4.Controllers
{
    public class HomeController : Controller
    {
        // Async action method with proper error handling
        public async Task<ActionResult> PrintPdfAdvanced()
        {
            try
            {
                // Create custom print settings
                var printSettings = new PrintSettings
                {
                    // Select specific printer
                    PrinterName = "Microsoft Print to PDF",
                    // Set paper size
                    PaperSize = PaperSize.A4,
                    // Configure orientation
                    PaperOrientation = PaperOrientation.Portrait,
                    // Set number of copies
                    NumberOfCopies = 1,
                    // Configure DPI for high-quality output
                    Dpi = 300
                };

                // Print asynchronously with custom settings
                await Printer.PrintAsync("Basic.pdf", printSettings);

                // Log successful print operation (optional)
                System.Diagnostics.Debug.WriteLine("Document printed successfully");

                // Return success view or redirect
                TempData["PrintMessage"] = "Document sent to printer successfully!";
                return RedirectToAction("Index");
            }
            catch (Exception ex)
            {
                // Handle printing errors gracefully
                System.Diagnostics.Debug.WriteLine($"Printing error: {ex.Message}");
                TempData["ErrorMessage"] = "Unable to print document. Please try again.";
                return RedirectToAction("Index");
            }
        }
    }
}
using IronPrint;
using System;
using System.Threading.Tasks;
using System.Web.Mvc;

namespace WebApplication4.Controllers
{
    public class HomeController : Controller
    {
        // Async action method with proper error handling
        public async Task<ActionResult> PrintPdfAdvanced()
        {
            try
            {
                // Create custom print settings
                var printSettings = new PrintSettings
                {
                    // Select specific printer
                    PrinterName = "Microsoft Print to PDF",
                    // Set paper size
                    PaperSize = PaperSize.A4,
                    // Configure orientation
                    PaperOrientation = PaperOrientation.Portrait,
                    // Set number of copies
                    NumberOfCopies = 1,
                    // Configure DPI for high-quality output
                    Dpi = 300
                };

                // Print asynchronously with custom settings
                await Printer.PrintAsync("Basic.pdf", printSettings);

                // Log successful print operation (optional)
                System.Diagnostics.Debug.WriteLine("Document printed successfully");

                // Return success view or redirect
                TempData["PrintMessage"] = "Document sent to printer successfully!";
                return RedirectToAction("Index");
            }
            catch (Exception ex)
            {
                // Handle printing errors gracefully
                System.Diagnostics.Debug.WriteLine($"Printing error: {ex.Message}");
                TempData["ErrorMessage"] = "Unable to print document. Please try again.";
                return RedirectToAction("Index");
            }
        }
    }
}
$vbLabelText   $csharpLabel

此增強實作展示 Print Settings 指南中的概念，包括指定印表機名稱、設定紙張大小以及適當處理錯誤。

在網頁環境中進行印表機選擇時，請利用 Get Printer Names 功能來動態填入可用的印表機清單：

// Get list of available printers
public ActionResult GetAvailablePrinters()
{
    var printers = Printer.GetPrinterNames();
    ViewBag.PrinterList = new SelectList(printers);
    return View();
}
// Get list of available printers
public ActionResult GetAvailablePrinters()
{
    var printers = Printer.GetPrinterNames();
    ViewBag.PrinterList = new SelectList(printers);
    return View();
}
$vbLabelText   $csharpLabel

對於需要使用者互動的場景，可考慮採用 Print with Dialog 的方式，不過這種方式比起網頁環境更適合桌面應用程式。

生產部署的其他注意事項

在使用 IronPrint 部署您的 ASP.NET 應用程式時，請考慮這些因素：

1.授權組態：對於 ASP.NET 應用程式，請在 Web.config 中設定您的授權金鑰。請參閱 Setting License Key in Web.config 指南以取得正確的設定。

2.印表機存取權限：確保應用程式池身分具有存取本機或網路印表機的權限。 Print Your Documents 文件提供了印表機存取要求。

3.錯誤處理：針對離線印表機或無法存取的文件實施強大的錯誤處理。 對於技術問題，請使用 Engineering Request 流程來解決複雜的問題。

4.效能：針對大量列印，實施佇列系統以有效管理列印請求。 異步 PrintAsync 非常適合此類實作。

如需全面的列印功能，請參閱 API Reference 以取得 IronPrint 命名空間中所有方法和屬性的詳細說明文件。

常見問題解答

如何在 ASP.NET Framework 應用程式中實作異步 PDF 列印？

您可以使用 IronPrint 的 PrintAsync 方法實現異步 PDF 列印。只需在您的控制器動作中加入 `return await IronPrint.Printer.PrintAsync("yourfile.pdf");` 即可。這種非阻塞方法可確保您的 Web 應用程式在處理列印請求時保持反應迅速，避免在進行文件列印作業時發生使用者介面凍結的情況。

為什麼在 Web 應用程式中應該使用異步列印而非同步列印？

使用 IronPrint 的 PrintAsync 方法進行異步列印，對於可能有多位使用者同時觸發列印作業的 Web 應用程式而言至關重要。與阻塞線程的同步列印方法不同，PrintAsync 可確保您的應用程式在處理並發請求時不會降低性能，即使在高負載下也能保持反應速度。

在我的 ASP.NET Framework 專案中加入 PDF 列印的最基本步驟是什麼？

最基本的工作流程包括 5 個步驟：1) 下載適用於 C# 的 IronPrint 函式庫；2) 將 IronPrint 匯入您的 class 檔案；3) 在您的檢視中加入列印按鈕；4) 在您的控制器動作中實作 PrintAsync；5) 按下按鈕時確認文件列印工作正常。這個簡化的流程只需最少的程式碼變更。

如何在 ASP.NET 視圖中加入列印按鈕？

在您的 Index.cshtml 或首頁檢視中，新增一個可觸發控制器動作的按鈕。使用類似 `` 的 HTML。按一下此按鈕時，會在您的 Home 控制器中呼叫 PrintPDF ActionResult 方法。

使用非同步列印時，我可以自訂列印設定嗎？

是的，IronPrint 提供全面的功能，包括自訂列印設定和印表機資訊擷取。這些功能使其成為需要強大列印功能的企業級 ASP.NET 應用程式的理想選擇，並可設定印表機選擇、頁面方向、邊界及其他列印參數。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 38,454 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronPrint
執行範例 觀看您的文件打到印表機上。