Drucken in einer ASP.NET Framework Web App mit C#

Updated: 22. April 2026

Die PrintAsync Methode von IronPrint ermöglicht das nicht blockierende Drucken von Dokumenten in ASP.NET-Webanwendungen und verhindert so ein Einfrieren der Benutzeroberfläche während der Verarbeitung von Druckanforderungen. Dieser asynchrone Ansatz gewährleistet, dass responsive Webanwendungen Druckvorgänge ohne blockierende Threads verarbeiten können.

Webanwendungen erfordern häufig den Druck von Dokumenten als Endausgabe. Die Integration von Druckfunktionen in Webanwendungen stellt eine Herausforderung dar, insbesondere wenn es um asynchrone Vorgänge geht. IronPrint löst dies mit der PrintAsync Funktion. Dieses Tutorial demonstriert die Implementierung von PrintAsync mit ASP.NET Core, um eine Webanwendung zu erstellen, die Dokumente druckt, ohne blockierend zu wirken.

Vor der Implementierung ist zu beachten, dass IronPrint umfassende Funktionen bietet, darunter Druckerinformationen abrufen und Benutzerdefinierte Druckeinstellungen. Diese Fähigkeiten machen es ideal für ASP.NET-Unternehmensanwendungen, die robuste Druckfunktionen erfordern.

Schnellstart: Asynchrone PDF-Druck in ASP.NET

Installieren Sie IronPrint über NuGet: Install-Package IronPrint
Importieren Sie IronPrint in die Controller-Datei
Fügen Sie eine Drucktaste hinzu, um die Methode auszulösen
Rufen Sie await Printer.PrintAsync("file.pdf") in der Controller-Aktion auf
Überprüfen Sie den Dokumentendruck beim Drücken der Taste

1Install IronPrint with NuGet Package Manager
PM > Install-Package IronPrint
```
Install-Package IronPrint
```

2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

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

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

3Bereitstellen zum Testen in Ihrer Live-Umgebung

Beginnen Sie noch heute, IronPrint in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

Legen Sie los mit IronPrint

Start using IronPrint in your project today with a free trial.

Erster Schritt:

Wie man in einer ASP.NET-Webanwendung druckt

Installieren Sie die C#-Druckbibliothek von NuGet
Importieren Sie IronPrint in den Controller
Fügen Sie eine Drucktaste hinzu, um die Aktion auszulösen
Rufen Sie PrintAsync in der Controllermethode auf

Wie implementiere ich asynchronen PDF-Druck in ASP.NET?

Dieses Beispiel zeigt das asynchrone Drucken einer PDF-Datei in einem ASP.NET Web Application (.NET Framework) Projekt mit der PrintAsync Methode. PrintAsync startet das Drucken asynchron, sodass die Anwendung im Vergleich zu synchronen Print Methoden, die Threads blockieren, reaktionsfähig bleibt.

Der asynchrone Ansatz ist entscheidend für Webanwendungen, bei denen mehrere Benutzer gleichzeitig Druckvorgänge auslösen können. Im Gegensatz zur synchronen Print Methode sorgt PrintAsync dafür, dass Ihre Anwendung gleichzeitige Anfragen ohne Leistungseinbußen verarbeitet.

Wo soll ich die Schaltfläche "Drucken" einfügen?

Fügen Sie in Ihrer "Index.cshtml" (oder Startseitenansicht) einen Knopf hinzu, der bei einem Klick eine Aktion auslöst. Dieser Button ruft eine ActionResult Methode in Ihrem Controller auf:

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

<main>
    <section class="row" aria-labelledby="aspnetTitle">
        <h1 id="title">ASP.NET</h1>
        <p>
            <!-- Button that triggers the PrintPdf ActionResult -->
            <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>
            <!-- Button that triggers the PrintPdf ActionResult -->
            <a class="btn btn-primary btn-md" onclick="location.href='@Url.Action("PrintPdf", "Home")'">Print PDF</a>
        </p>
    </section>
</main>

HTML

ASP.NET-Anwendungsschnittstelle zeigt Navigationsmenü und blauen 'PDF drucken'-Button zum Erstellen von PDFs

Wie kann ich PrintAsync in meinem Controller konfigurieren?

Implementieren Sie in Ihrem HomeController die PrintAsync Methode. Diese Methode führt Druckvorgänge asynchron aus und verbessert so die Reaktionsfähigkeit der Anwendung. Stellen Sie vor der Implementierung sicher, dass der Lizenzschlüssel für den Produktionseinsatz richtig konfiguriert ist.

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
        }
    }
}

Imports IronPrint
Imports System.Threading.Tasks
Imports System.Web.Mvc

Namespace WebApplication4.Controllers
	Public Class HomeController
		Inherits Controller

		Public Function Index() As ActionResult
			Return View()
		End Function

		Public Function About() As ActionResult
			ViewBag.Message = "Your application description page."
			Return View()
		End Function

		Public Function Contact() As ActionResult
			Return View()
		End Function

		' Action method to handle the printing operation
		' This makes use of the PrintAsync method to avoid blocking the main thread
		Public Function PrintPdf() As ActionResult
			' 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
		End Function
	End Class
End Namespace

Imports IronPrint
Imports System.Threading.Tasks
Imports System.Web.Mvc

Namespace WebApplication4.Controllers
	Public Class HomeController
		Inherits Controller

		Public Function Index() As ActionResult
			Return View()
		End Function

		Public Function About() As ActionResult
			ViewBag.Message = "Your application description page."
			Return View()
		End Function

		Public Function Contact() As ActionResult
			Return View()
		End Function

		' Action method to handle the printing operation
		' This makes use of the PrintAsync method to avoid blocking the main thread
		Public Function PrintPdf() As ActionResult
			' 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
		End Function
	End Class
End Namespace

Für fortgeschrittene Szenarien sollten Sie geeignete async/await-Muster implementieren und den Druckvorgang anpassen. Hier ist ein erweitertes Beispiel, das die Fehlerbehandlung und benutzerdefinierte Druckeinstellungen zeigt:

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");
            }
        }
    }
}

Imports IronPrint
Imports System
Imports System.Threading.Tasks
Imports System.Web.Mvc

Namespace WebApplication4.Controllers
    Public Class HomeController
        Inherits Controller

        ' Async action method with proper error handling
        Public Async Function PrintPdfAdvanced() As Task(Of ActionResult)
            Try
                ' Create custom print settings
                Dim printSettings As New PrintSettings With {
                    ' 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 ex As Exception
                ' Handle printing errors gracefully
                System.Diagnostics.Debug.WriteLine($"Printing error: {ex.Message}")
                TempData("ErrorMessage") = "Unable to print document. Please try again."
                Return RedirectToAction("Index")
            End Try
        End Function
    End Class
End Namespace

Imports IronPrint
Imports System
Imports System.Threading.Tasks
Imports System.Web.Mvc

Namespace WebApplication4.Controllers
    Public Class HomeController
        Inherits Controller

        ' Async action method with proper error handling
        Public Async Function PrintPdfAdvanced() As Task(Of ActionResult)
            Try
                ' Create custom print settings
                Dim printSettings As New PrintSettings With {
                    ' 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 ex As Exception
                ' Handle printing errors gracefully
                System.Diagnostics.Debug.WriteLine($"Printing error: {ex.Message}")
                TempData("ErrorMessage") = "Unable to print document. Please try again."
                Return RedirectToAction("Index")
            End Try
        End Function
    End Class
End Namespace

Diese erweiterte Implementierung zeigt Konzepte aus dem Handbuch für Druckeinstellungen, einschließlich der Angabe von Druckernamen, der Konfiguration von Papierformaten und der angemessenen Behandlung von Fehlern.

Bei der Arbeit mit der Druckerauswahl in Webumgebungen sollten Sie die Funktion Druckernamen abrufen nutzen, um die Listen der verfügbaren Drucker dynamisch aufzufüllen:

// 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();
}

' Get list of available printers
Public Function GetAvailablePrinters() As ActionResult
    Dim printers = Printer.GetPrinterNames()
    ViewBag.PrinterList = New SelectList(printers)
    Return View()
End Function

' Get list of available printers
Public Function GetAvailablePrinters() As ActionResult
    Dim printers = Printer.GetPrinterNames()
    ViewBag.PrinterList = New SelectList(printers)
    Return View()
End Function

Für Szenarien, die eine Benutzerinteraktion erfordern, sollten Sie einen Drucken mit Dialog-Ansatz in Erwägung ziehen, der sich allerdings eher für Desktop-Anwendungen als für Webumgebungen eignet.

Zusätzliche Überlegungen für den Produktionseinsatz

Wenn Sie Ihre ASP.NET-Anwendung mit IronPrint bereitstellen, sollten Sie diese Faktoren berücksichtigen:

Lizenz-Konfiguration: Für ASP.NET-Anwendungen konfigurieren Sie Ihren Lizenzschlüssel in der Web.config. Siehe die Lizenzschlüssel in Web.config festlegen Anleitung für die richtige Einrichtung.
Druckerzugriff: Stellen Sie sicher, dass die Identität des Anwendungspools die Berechtigung hat, auf lokale oder Netzwerkdrucker zuzugreifen. Die Drucken Sie Ihre Dokumente-Dokumentation enthält die Anforderungen für den Druckerzugang.
Fehlerbehandlung: Implementieren Sie eine robuste Fehlerbehandlung für Offline-Drucker oder unzugängliche Dokumente. Für technische Fragen verwenden Sie den Engineering Request Prozess, um komplexe Probleme zu lösen.
Leistung: Implementieren Sie bei hohem Druckaufkommen ein Warteschlangensystem, um Druckaufträge effizient zu verwalten. Die asynchrone PrintAsync ist ideal für solche Implementierungen.

Für umfassende Druckmöglichkeiten konsultieren Sie die API Referenz für detaillierte Dokumentationen zu allen Methoden und Eigenschaften im IronPrint Namespace.

Häufig gestellte Fragen

Wie kann ich asynchronen PDF-Druck in ASP.NET Framework-Anwendungen implementieren?

Mit der PrintAsync-Methode von IronPrint können Sie asynchronen PDF-Druck implementieren. Fügen Sie einfach `return await IronPrint.Printer.PrintAsync("yourfile.pdf");` in Ihre Controller-Aktion ein. Dieser nicht-blockierende Ansatz stellt sicher, dass Ihre Webanwendung während der Verarbeitung von Druckanfragen reaktionsfähig bleibt, und verhindert ein Einfrieren der Benutzeroberfläche während des Dokumentendrucks.

Warum sollte ich in Webanwendungen asynchrones Drucken anstelle von synchronem Drucken verwenden?

Asynchrones Drucken mit der PrintAsync-Methode von IronPrint ist entscheidend für Webanwendungen, bei denen mehrere Benutzer gleichzeitig Druckvorgänge auslösen können. Im Gegensatz zu synchronen Druckmethoden, die Threads blockieren, stellt PrintAsync sicher, dass Ihre Anwendung gleichzeitige Anfragen ohne Leistungseinbußen verarbeitet und die Reaktionsfähigkeit auch bei hoher Last aufrechterhält.

Was sind die minimalen Schritte, um den PDF-Druck zu meinem ASP.NET Framework-Projekt hinzuzufügen?

Der minimale Arbeitsablauf umfasst 5 Schritte: 1) Herunterladen der IronPrint-Bibliothek für C#, 2) Importieren von IronPrint in Ihre Klassendatei, 3) Hinzufügen einer Druckschaltfläche zu Ihrer Ansicht, 4) Implementieren von PrintAsync in Ihrer Controller-Aktion und 5) Überprüfen, ob der Dokumentendruck funktioniert, wenn die Schaltfläche gedrückt wird. Dieser rationalisierte Prozess erfordert nur minimale Änderungen am Code.

Wie füge ich eine Druckschaltfläche zu meiner ASP.NET-Ansicht hinzu?

Fügen Sie in Ihre Index.cshtml oder Ihre Homepage-Ansicht eine Schaltfläche ein, die eine Controller-Aktion auslöst. Verwenden Sie HTML wie ``. Wenn Sie auf diese Schaltfläche klicken, wird die Methode PrintPDF ActionResult in Ihrem Home-Controller aufgerufen.

Kann ich die Druckeinstellungen anpassen, wenn ich asynchrones Drucken verwende?

Ja, IronPrint bietet umfassende Funktionen, darunter benutzerdefinierte Druckeinstellungen und die Abfrage von Druckerinformationen. Diese Funktionen machen es ideal für ASP.NET-Unternehmensanwendungen, die eine robuste Druckfunktionalität mit Optionen zur Konfiguration von Druckerauswahl, Seitenausrichtung, Rändern und anderen Druckparametern benötigen.

How can I handle errors during the printing process?

Use try-catch blocks around your PrintAsync calls to catch exceptions and handle them gracefully, providing user feedback or logging as necessary.

What should I consider for deploying an ASP.NET application using IronPrint?

Ensure your application's license configuration, printer access permissions, and error handling mechanisms are properly set up in production.

How can I dynamically populate available printer lists in my application?

Use the GetPrinterNames method from IronPrint to retrieve and dynamically display a list of available printers to users.

What is the role of the PrintAsync method in managing high-volume printing?

PrintAsync supports high-volume printing by enabling a queue system that efficiently manages print requests without blocking the application.

Is it possible to use IronPrint for printing with a dialog in a web environment?

While it's possible to integrate a print dialog in desktop applications, this approach is less suitable for web environments, where asynchronous methods are preferred for best performance.

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

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.

...