Willkommen zu diesem Tutorial, in dem wir erkunden, wie man Word-Dokumente mit Microsoft Interop in einer C# Konsolenanwendung druckt. Dieser anfängerfreundliche Leitfaden führt Sie durch die Schritte, um Microsoft Word-Dokumente programmgesteuert zu drucken.

Voraussetzungen

Bevor Sie in den Code eintauchen, ist es wichtig, ein paar Dinge einzurichten:

• Microsoft Word-Installation: Stellen Sie sicher, dass Microsoft Word auf Ihrem System installiert ist. Falls nicht, besuchen Sie die offizielle Microsoft-Website Ihres Computers oder den App Store, um es zu installieren.

• Visual Studio-Setup: Sie sollten Visual Studio mit der Möglichkeit zum Erstellen einer Konsolenanwendung installiert haben. Wenn Sie ein Anfänger sind, sollten Sie Visual Studio Community herunterladen, das kostenlos und ausreichend für unsere Zwecke ist.

• Ein Word-Dokument: Halten Sie ein Word-Beispieldokument auf Ihrem Rechner zu Testzwecken bereit. Dies wird das Dokument sein, das wir an den Drucker senden.

Einrichten der Umgebung

Erstellen einer neuen Konsolenanwendung

1. Öffnen Sie Visual Studio.
2. Klicken Sie auf "Neues Projekt erstellen".
3. Suchen Sie nach "Konsolen-App" und wählen Sie die passende C# Vorlage aus.
4. Benennen Sie Ihr Projekt (z.B. "InteropPrintConsoleTutorial") und wählen Sie einen geeigneten Speicherort.

Hinzufügen der Interop-Referenz

Die Verwendung von Interop erfordert eine Referenz zur Microsoft Office Interop-Bibliothek. So fügen Sie sie hinzu:

1. Klicken Sie in Visual Studio mit der rechten Maustaste auf Ihr Konsolenprojekt im Projektmappen-Explorer.
2. Navigieren Sie zu Hinzufügen > Referenz.
3. Im Referenz-Manager-Fenster gehen Sie zum COM-Tab.
4. Geben Sie "Microsoft Word" in die Suchleiste ein, um die Liste zu filtern.
5. Wählen Sie aus den Ergebnissen "Microsoft Word xx.x Objektbibliothek" (wobei xx.x die Versionsnummer angibt).
6. Klicken Sie auf die Schaltfläche OK, um die Referenz hinzuzufügen.

Sie können es auch mit dem NuGet-Paket-Manager installieren.

Anwendungseinstellungen überprüfen

Stellen Sie sicher, dass das Ziel-Framework Ihrer Anwendung mit der Interop-Bibliothek kompatibel ist. Dies können Sie überprüfen, indem Sie mit der rechten Maustaste auf Ihr Projekt im Projektmappen-Explorer klicken, Eigenschaften auswählen und dann das Ziel-Framework unter dem Abschnitt Anwendung anzeigen. Wenn Sie Probleme mit der Version der Interop-Bibliothek haben, ziehen Sie in Betracht, das erforderliche Paket oder Assembly herunterzuladen oder die Ziel-Framework-Version anzupassen.

Mit der aufgebauten Umgebung können Sie nun mit dem Programmierprozess fortfahren.

Das Dokumentobjekt verstehen

Das Dokumentobjekt steht im Zentrum der Interop-Dienste bei der Arbeit mit Word-Dokumenten. Dieses Objekt stellt ein Microsoft Word-Dokument dar und bietet alle seine Funktionalitäten.

Eine häufige Aufgabe ist das Öffnen eines Dokuments:

using Word = Microsoft.Office.Interop.Word;

// Object needed to avoid passing specific parameters
object oMissing = Type.Missing;

// File path to the Word document you want to open
object fileName = @"C:\path_to_document\document.docx";

// Create a new instance of the Word application
Word.Application wordApp = new Word.Application();

// Open the document with specified parameters
Word._Document wordDoc = wordApp.Documents.Open(
    ref fileName, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing);

using Word = Microsoft.Office.Interop.Word;

// Object needed to avoid passing specific parameters
object oMissing = Type.Missing;

// File path to the Word document you want to open
object fileName = @"C:\path_to_document\document.docx";

// Create a new instance of the Word application
Word.Application wordApp = new Word.Application();

// Open the document with specified parameters
Word._Document wordDoc = wordApp.Documents.Open(
    ref fileName, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing, ref oMissing, ref oMissing, ref oMissing, ref oMissing, 
    ref oMissing);

Imports Word = Microsoft.Office.Interop.Word

' Object needed to avoid passing specific parameters
Private oMissing As Object = Type.Missing

' File path to the Word document you want to open
Private fileName As Object = "C:\path_to_document\document.docx"

' Create a new instance of the Word application
Private wordApp As New Word.Application()

' Open the document with specified parameters
Private wordDoc As Word._Document = wordApp.Documents.Open(fileName, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing)

Imports Word = Microsoft.Office.Interop.Word

' Object needed to avoid passing specific parameters
Private oMissing As Object = Type.Missing

' File path to the Word document you want to open
Private fileName As Object = "C:\path_to_document\document.docx"

' Create a new instance of the Word application
Private wordApp As New Word.Application()

' Open the document with specified parameters
Private wordDoc As Word._Document = wordApp.Documents.Open(fileName, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing, oMissing)

Mehrere Parameter mit ref oMissing mögen abschreckend wirken, aber sie sind wesentlich für die Open-Methode, die zahlreiche Argumente erwartet, von denen die meisten optional sind.

Implementierung der Druckfunktionalität

Mit unserer aufgebauten Umgebung und dem Verständnis des Dokumentobjekts ist es an der Zeit, in die Kernfunktionalität des Druckens von Word-Dokumenten einzusteigen.

Grundlegendes Drucken von Word-Dokumenten

Um das Dokument zu drucken, können Sie die folgende Methode verwenden:

// Method to print the document using default printer settings
private void ButtonPrint_Click(object sender, EventArgs e)
{
    wordDoc.PrintOut(); // Sends the document to the default printer
}

// Method to print the document using default printer settings
private void ButtonPrint_Click(object sender, EventArgs e)
{
    wordDoc.PrintOut(); // Sends the document to the default printer
}

' Method to print the document using default printer settings
Private Sub ButtonPrint_Click(ByVal sender As Object, ByVal e As EventArgs)
	wordDoc.PrintOut() ' Sends the document to the default printer
End Sub

' Method to print the document using default printer settings
Private Sub ButtonPrint_Click(ByVal sender As Object, ByVal e As EventArgs)
	wordDoc.PrintOut() ' Sends the document to the default printer
End Sub

Diese Methode sendet das Dokument mit den Standardeinstellungen an den Standarddrucker.

Drucken von Word-Dokumenten mit Anpassungen

Wenn Sie einen Druckdialog einführen, Druckereinstellungen anpassen oder sogar mehrere Seiten drucken möchten, benötigen Sie einen detaillierteren Ansatz:

// Method to print the document with custom settings
private void ButtonPrintWithSettings_Click(object sender, EventArgs e)
{
    // Number of copies to print
    object copies = "1";

    // Page range to print, e.g., pages 1 to 3
    object pages = "1-3";

    // Print the document with specified copies and page range
    wordDoc.PrintOut(Copies: ref copies, Pages: ref pages);
}

// Method to print the document with custom settings
private void ButtonPrintWithSettings_Click(object sender, EventArgs e)
{
    // Number of copies to print
    object copies = "1";

    // Page range to print, e.g., pages 1 to 3
    object pages = "1-3";

    // Print the document with specified copies and page range
    wordDoc.PrintOut(Copies: ref copies, Pages: ref pages);
}

' Method to print the document with custom settings
Private Sub ButtonPrintWithSettings_Click(ByVal sender As Object, ByVal e As EventArgs)
	' Number of copies to print
	Dim copies As Object = "1"

	' Page range to print, e.g., pages 1 to 3
	Dim pages As Object = "1-3"

	' Print the document with specified copies and page range
	wordDoc.PrintOut(Copies:= copies, Pages:= pages)
End Sub

' Method to print the document with custom settings
Private Sub ButtonPrintWithSettings_Click(ByVal sender As Object, ByVal e As EventArgs)
	' Number of copies to print
	Dim copies As Object = "1"

	' Page range to print, e.g., pages 1 to 3
	Dim pages As Object = "1-3"

	' Print the document with specified copies and page range
	wordDoc.PrintOut(Copies:= copies, Pages:= pages)
End Sub

Im obigen Quellcode geben wir den Seitenbereich und die Anzahl der Kopien an, aber die potenziellen Anpassungen sind enorm.

Anpassen von Druckeinstellungen

Die Fähigkeit, Druckeinstellungen zu ändern, ist das, was die programmgesteuerte Kontrolle auszeichnet. Ob Sie die Druckereinstellungen anpassen, einen bestimmten Drucker definieren oder das Dokument sogar stillschweigend drucken möchten, alles ist mit Interop in Reichweite.

Stilles Drucken

Stilles Drucken bedeutet, das Dokument ohne Benutzerinteraktion an den Drucker zu senden.

// Object to determine whether to print in the background or not
object background = false;

// Print the document silently (no user interactions)
wordDoc.PrintOut(Background: ref background);

// Object to determine whether to print in the background or not
object background = false;

// Print the document silently (no user interactions)
wordDoc.PrintOut(Background: ref background);

' Object to determine whether to print in the background or not
Dim background As Object = False

' Print the document silently (no user interactions)
wordDoc.PrintOut(Background:= background)

' Object to determine whether to print in the background or not
Dim background As Object = False

' Print the document silently (no user interactions)
wordDoc.PrintOut(Background:= background)

Einen Drucker spezifizieren

Um ein Dokument auf einem bestimmten Drucker zu drucken, der nicht der Standarddrucker ist:

// Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name";

// Print the document using the specified printer
wordDoc.PrintOut();

// Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name";

// Print the document using the specified printer
wordDoc.PrintOut();

' Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name"

' Print the document using the specified printer
wordDoc.PrintOut()

' Set the active printer to a specified printer by name
wordApp.ActivePrinter = "Printer Name"

' Print the document using the specified printer
wordDoc.PrintOut()

Erweiterte Druckereinstellungen

Über das einfache Spezifizieren des Druckers hinaus könnte es notwendig sein, die Druckereinstellungen anzupassen:

// Creates a PrintDialog to allow the user to choose printer settings
PrintDialog printDialog = new PrintDialog();
if (printDialog.ShowDialog() == DialogResult.OK)
{
    // Sets the Word application's active printer to the user's choice
    wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName;
    
    // Prints the document using user's selected printer settings
    wordDoc.PrintOut();
}

// Creates a PrintDialog to allow the user to choose printer settings
PrintDialog printDialog = new PrintDialog();
if (printDialog.ShowDialog() == DialogResult.OK)
{
    // Sets the Word application's active printer to the user's choice
    wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName;
    
    // Prints the document using user's selected printer settings
    wordDoc.PrintOut();
}

' Creates a PrintDialog to allow the user to choose printer settings
Dim printDialog As New PrintDialog()
If printDialog.ShowDialog() = DialogResult.OK Then
    ' Sets the Word application's active printer to the user's choice
    wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName

    ' Prints the document using user's selected printer settings
    wordDoc.PrintOut()
End If

' Creates a PrintDialog to allow the user to choose printer settings
Dim printDialog As New PrintDialog()
If printDialog.ShowDialog() = DialogResult.OK Then
    ' Sets the Word application's active printer to the user's choice
    wordApp.ActivePrinter = printDialog.PrinterSettings.PrinterName

    ' Prints the document using user's selected printer settings
    wordDoc.PrintOut()
End If

Auf diese Weise kann der Benutzer Einstellungen wie Orientierung, Duplexdruck und mehr manuell anpassen.

Einführung in IronWord

Während Microsoft Interop Funktionen zum Verwalten von Word-Dokumenten bietet, ist es nicht so robust und effizient, wie es für den ernsthaften kommerziellen Einsatz sein sollte. Betreten Sie IronWord—eine überlegene Alternative zu Interop für die Verarbeitung von Word-DOCX-Dateien. IronWord ermöglicht nahtloses Lesen, Schreiben und Bearbeiten von Excel-Dateien in C#. Erfahren Sie mehr darüber, wie Sie mit IronWord beginnen.

Abschluss

In diesem Tutorial haben wir die Schritte zur Nutzung von Microsoft Interop zum programmgesteuerten Drucken von Word-Dokumenten in einer C# Konsolen-Anwendung behandelt. Wir haben gesehen, wie man den Druckdialog anzeigt, benutzerdefinierte Druckeinstellungen setzt und verschiedene Druckaspekte kontrolliert, wie das Auswählen eines bestimmten Druckers oder das Definieren eines Seitenbereichs. Während Interop grundlegende Funktionen bietet, ist es wichtig anzumerken, dass es leistungsstarke Alternativen wie IronWord gibt.