Bu öğreticiye hoş geldiniz, burada Microsoft Interop kullanarak bir C# Konsol Uygulamasında Word belgelerini nasıl yazdıracağınızı inceleyeceğiz. Bu yeni başlayanlar için kılavuz, Microsoft Word belgelerini programatik olarak nasıl yazdıracağınızı adım adım açıklayacaktır.

Gereksinimler

Koda dalmadan önce, birkaç şeyin ayarlanması önemlidir:

• Microsoft Word Kurulumu: Sisteminizde Microsoft Word yüklü olduğundan emin olun. Eğer yüklü değilse, bilgisayarınızın resmi Microsoft web sitesine veya uygulama mağazasına giderek yükleyin.

• Visual Studio Kurulumu: Konsol Uygulaması oluşturma yeteneğine sahip Visual Studio'nun yüklü olması gerekir. Eğer bir başlayıcıysanız, ücretsiz ve ihtiyaçlarımız için yeterli olan Visual Studio Community'yi indirmeyi düşünün.

• Bir Word Belgesi: Test amaçları için makinenizde hazır bir örnek Word belgesi bulundurun. Bu, yazıcıya göndereceğimiz belge olacak.

Ortamı Ayarlama

Yeni Bir Konsol Uygulaması Oluşturun

1. Visual Studio'yu açın.
2. "Yeni bir proje oluştur" üzerine tıklayın.
3. "Console App" arayın ve uygun C# şablonunu seçin.
4. Projenizi adlandırın (örneğin, "InteropPrintConsoleTutorial") ve uygun bir yer seçin.

Interop Referansı Ekleme

Interop kullanımı, Microsoft Office Interop kütüphanesine bir referans eklemeyi gerektirir. İşte nasıl ekleneceği:

1. Visual Studio'da, Çözüm Gezgini'nde Konsol projenizi sağ tıklayın.
2. Ekle > Referans'a gidin.
3. Referans Yöneticisi penceresinde, COM sekmesine gidin.
4. Listeyi filtrelemek için arama çubuğuna "Microsoft Word" yazın.
5. Sonuçlardan "Microsoft Word xx.x Objekt Kütüphanesi"ni seçin (burada xx.x sürüm numarasını belirtir).
6. Referansı eklemek için Tamam düğmesine tıklayın.

NuGet Paket Yöneticisi'ni kullanarak da kurabilirsiniz.

Uygulama Ayarlarını Doğrulama

Uygulamanızın hedef çerçevesinin Interop kütüphanesi ile uyumlu olduğundan emin olun. Bunu, Çözüm Gezgini'nde projenize sağ tıklayıp, Özellikler'i seçerek ve ardından Uygulama sekmesinde Hedef çerçeve bölümüne bakarak kontrol edebilirsiniz. Interop kütüphanesinin sürümüyle ilgili sorunlarla karşılaşırsanız, gerekli paketi veya derlemeyi indirmeyi veya hedef çerçeve sürümünü ayarlamayı düşünün.

Ortam ayarlandıktan sonra, şimdi kodlama sürecine devam edebilirsiniz.

Belge Nesnesini Anlama

Belge nesnesi, Word belgeleriyle çalışırken Interop hizmetlerinin kalbinde yer alır. Bu nesne, bir Microsoft Word belgesini temsil eder ve tüm işlevlerini sağlar.

Yaygın bir görev, bir belge açmaktır:

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)

ref oMissing ile birden fazla parametre gözünüzde büyüyebilir, ancak Open yönteminin çoğu isteğe bağlı olan birçok argüman beklemesi nedeniyle bu önemlidir.

Yazdırma İşlevselliğinin Uygulanması

Ortamımızı kurduk ve belge nesnesini anladıktan sonra, Word belgelerini yazdırmanın temel işlevselliğine dalmanın zamanı geldi.

Word Belgesinin Temel Yazdırılması

Belgeyi yazdırmak için aşağıdaki metodu kullanabilirsiniz:

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

Bu yöntem dokümanı varsayılan yazıcıya varsayılan ayarlarla gönderir.

Özelleştirmeler ile Word Belgesi Yazdırma

Bir yazdırma penceresi sunmak, yazıcı ayarlarını özelleştirmek veya hatta birden fazla sayfa basmak isterseniz, daha ayrıntılı bir yaklaşıma ihtiyacınız olacak:

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

Yukarıdaki kaynak kodda, sayfa aralığını ve kopya sayısını belirtiyoruz, ancak potansiyel özelleştirmeler geniştir.

Yazdırma Ayarlarını Özelleştirme

Yazdırma ayarlarını değiştirebilme yeteneği, programatik kontrolü diğerlerinden ayırır. Yazıcı ayarlarını ayarlamak, belirli bir yazıcıyı tanımlamak veya belgesiz şekilde yazdırmak isteyip istemediğiniz önemli değil, Interop ile her şey ulaşılabilir.

Belgesiz Yazdırma

Belgesiz yazdırma, kullanıcı etkileşimi olmadan belgeyi yazıcıya göndermekle ilgilidir:

// 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)

Bir Yazıcıyı Belirleme

Belgeyi varsayılan olmayan belirli bir yazıcıda yazdırmak için:

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

Gelişmiş Yazıcı Ayarları

Yalnızca yazıcıyı belirlemenin ötesinde, yazıcı ayarlarını ayarlamak gerekebilir:

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

Bu şekilde, kullanıcı ayarlamaları manuel olarak yapabilir, örneğin yönlendirme, çift taraflı yazdırma ve daha fazlası.

IronWord Tanıtımı

Microsoft Interop, Word belgelerini yönetmek için işlevler sağlar, ancak ciddi ticari kullanım için olması gerektiği kadar sağlam ve verimli değildir. IronWord—Word DOCX dosya işlemeye yönelik Interop'a üstün bir alternatif olarak giriyor. IronWord, C# dilinde Excel dosyalarının kusursuz bir şekilde okunmasını, yazılmasını ve yönetilmesini sağlar. IronWord ile nasıl başlayacağınızı öğrenin.

Sonuç

Bu öğreticide, C# Konsol Uygulamasında Word belgelerini programatik olarak yazdırmak için Microsoft Interop'u kullanmanın aşamalarını inceledik. Yazdırma penceresini nasıl göstereceğimizi, özel yazdırma ayarlarını nasıl belirleyeceğimizi ve belirli bir yazıcı seçmek veya sayfa aralığını tanımlamak gibi çeşitli yazdırma yönlerini nasıl kontrol edeceğimizi gördük. Interop temel yetenekler sunarken, IronWord gibi güçlü alternatifler de vardır.