Automatisieren von Microsoft Word zum Ausführen des Seriendrucks aus Visual C #

Eine Microsoft Visual Basic .NET-Version dieses Artikels finden Sie unter 301656.

Zusammenfassung

In diesem Artikel wird veranschaulicht, wie Sie Microsoft Word automatisieren, um ein Seriendruckdokument mithilfe von Microsoft Visual C# 2005 oder Microsoft Visual C# .NET zu erstellen.

Weitere Informationen

Automatisierung ist ein Prozess, der es Anwendungen, die in Sprachen wie Visual C# 2005 oder Visual C# .NET geschrieben sind, ermöglicht, andere Anwendungen programmgesteuert zu steuern. Mit der Automatisierung von Word können Sie Aktionen wie das Erstellen neuer Dokumente, das Hinzufügen von Text zu Dokumenten und das Formatieren von Dokumenten ausführen. Mit Word und anderen Microsoft Office-Anwendungen können nahezu alle Aktionen, die Sie manuell über die Benutzeroberfläche ausführen können, auch programmgesteuert mithilfe der Automatisierung ausgeführt werden.

Word macht diese programmgesteuerte Funktionalität über ein Objektmodell verfügbar. Das Objektmodell ist eine Auflistung von Klassen und Methoden, die als Gegenstück zu den logischen Komponenten von Word dienen. Es gibt z. B. ein Application-Objekt, ein Document-Objekt und ein Paragraph-Objekt, von denen jede die Funktionalität dieser Komponenten in Word enthält. Um über Visual C# 2005 oder Visual C# .NET auf das Objektmodell zuzugreifen, können Sie einen Projektverweise auf die Typbibliothek festlegen.

In diesem Artikel wird das Festlegen des richtigen Projektverweises auf die Word-Typbibliothek für Visual C# .NET veranschaulicht, und es wird Beispielcode zum Automatisieren von Word bereitgestellt.

Erstellen des Automatisierungsbeispiels

1. Starten Sie Microsoft Visual Studio 2005 oder Microsoft Visual Studio .NET.

2. Klicken Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt. Wählen Sie "Windows-Anwendung" aus den Visual C#-Projekttypen aus. Form1 wird standardmäßig erstellt.

3. Fügen Sie einen Verweis auf die Microsoft Word 11.0-Objektbibliothek in Visual Studio 2005 oder auf die Microsoft Word-Objektbibliothek in Visual Studio .NET hinzu. Gehen Sie dazu wie folgt vor:

   1. On the Project menu, click Add Reference.

   2. Suchen Sie auf der Registerkarte COM die Microsoft Word-Objektbibliothek, und klicken Sie dann auf "Auswählen".

      Suchen Sie in Visual Studio 2005 auf der Registerkarte COM nach der Microsoft Word 11.0-Objektbibliothek.

      Hinweis Microsoft Office 2003 enthält primäre Interopassemblys (PRIMARY Interop Assemblies, PIAs). Microsoft Office XP enthält keine PIAs, sie können jedoch heruntergeladen werden.

   3. Klicken Sie im Dialogfeld "Verweise hinzufügen" auf "OK", um Ihre Auswahl zu übernehmen.

4. Wählen Sie im Menü "Ansicht" die Toolbox aus, um die Toolbox anzuzeigen, und fügen Sie formular1 eine Schaltfläche hinzu.

5. Doppelklicken Sie auf Schaltfläche1. Das Codefenster für das Formular wird angezeigt.

6. Ersetzen Sie im Codefenster den folgenden Code

     private void button1_Click(object sender, System.EventArgs e)
     {
     }
   
   

   mit:

   Word.Application wrdApp;
   Word._Document wrdDoc;
   Object oMissing = System.Reflection.Missing.Value;
   Object oFalse = false;
   
   private void InsertLines(int LineNum)
   {
   int iCount;
   
   // Insert "LineNum" blank lines.
   for(iCount = 1; iCount<=LineNum; iCount++) 
   {
   wrdApp.Selection.TypeParagraph();
   }
   }
   
   private void FillRow(Word._Document oDoc, int Row, string Text1,
   string Text2, string Text3, string Text4)
   {
   // Insert the data into the specific cell.
   oDoc.Tables[1].Cell(Row,1).Range.InsertAfter(Text1);
   oDoc.Tables[1].Cell(Row,2).Range.InsertAfter(Text2);
   oDoc.Tables[1].Cell(Row,3).Range.InsertAfter(Text3);
   oDoc.Tables[1].Cell(Row,4).Range.InsertAfter(Text4);
   }
   
   private void CreateMailMergeDataFile()
   {
   Word._Document oDataDoc;
   int iCount;
   
   Object oName = "C:\\DataDoc.doc";
   Object oHeader = "FirstName, LastName, Address, CityStateZip";
   wrdDoc.MailMerge.CreateDataSource(ref oName,ref oMissing, 
   ref oMissing,ref oHeader, ref oMissing, ref oMissing, 
   ref oMissing, ref oMissing, ref oMissing);
   
   // Open the file to insert data.
   oDataDoc = wrdApp.Documents.Open(ref oName,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 */);
   
   for (iCount=1; iCount<=2; iCount++)
   {
   oDataDoc.Tables[1].Rows.Add(ref oMissing);
   }
   // Fill in the data.
   FillRow(oDataDoc, 2, "Steve", "DeBroux", 
   "4567 Main Street", "Buffalo, NY  98052");
   FillRow(oDataDoc, 3, "Jan", "Miksovsky", 
   "1234 5th Street", "Charlotte, NC  98765");
   FillRow(oDataDoc, 4, "Brian", "Valentine", 
   "12348 78th Street  Apt. 214", 
   "Lubbock, TX  25874");
   // Save and close the file.
   oDataDoc.Save();
   oDataDoc.Close(ref oFalse, ref oMissing, ref oMissing);
   }
   
   private void button1_Click(object sender, System.EventArgs e)
   {
   Word.Selection wrdSelection;
   Word.MailMerge wrdMailMerge;
   Word.MailMergeFields wrdMergeFields;
   Word.Table wrdTable;
   string StrToAdd;
   
   // Create an instance of Word  and make it visible.
   wrdApp = new Word.Application();
   wrdApp.Visible = true;
   
   // Add a new document.
   wrdDoc = wrdApp.Documents.Add(ref oMissing,ref oMissing,
   ref oMissing,ref oMissing);
   wrdDoc.Select();
   
   wrdSelection = wrdApp.Selection;
   wrdMailMerge = wrdDoc.MailMerge;
   
   // Create a MailMerge Data file.
   CreateMailMergeDataFile();
   
   // Create a string and insert it into the document.
   StrToAdd = "State University\r\nElectrical Engineering Department";
   wrdSelection.ParagraphFormat.Alignment  = 
   Word.WdParagraphAlignment.wdAlignParagraphCenter;
   wrdSelection.TypeText(StrToAdd);
   
   InsertLines(4);
   
   // Insert merge data.
   wrdSelection.ParagraphFormat.Alignment = 
   Word.WdParagraphAlignment.wdAlignParagraphLeft;
   wrdMergeFields = wrdMailMerge.Fields;
   wrdMergeFields.Add(wrdSelection.Range, "FirstName");
   wrdSelection.TypeText(" ");
   wrdMergeFields.Add(wrdSelection.Range, "LastName");
   wrdSelection.TypeParagraph();
   
   wrdMergeFields.Add(wrdSelection.Range, "Address");
   wrdSelection.TypeParagraph();
   wrdMergeFields.Add(wrdSelection.Range, "CityStateZip");
   
   InsertLines(2);
   
   // Right justify the line and insert a date field
   // with the current date.
   wrdSelection.ParagraphFormat.Alignment = 
   Word.WdParagraphAlignment.wdAlignParagraphRight;
   
   Object objDate = "dddd, MMMM dd, yyyy";
   wrdSelection.InsertDateTime(ref objDate,ref oFalse,ref oMissing, 
   ref oMissing, ref oMissing);
   
   InsertLines(2);
   
   // Justify the rest of the document.
   wrdSelection.ParagraphFormat.Alignment = 
   Word.WdParagraphAlignment.wdAlignParagraphJustify;    
   
   wrdSelection.TypeText("Dear ");
   wrdMergeFields.Add(wrdSelection.Range, "FirstName");
   wrdSelection.TypeText(",");
   InsertLines(2);
   
   // Create a string and insert it into the document.
   StrToAdd = "Thank you for your recent request for next " +
   "semester's class schedule for the Electrical " +
   "Engineering Department. Enclosed with this " +
   "letter is a booklet containing all the classes " +
   "offered next semester at State University.  " +
   "Several new classes will be offered in the " +
   "Electrical Engineering Department next semester.  " +
   "These classes are listed below.";
   wrdSelection.TypeText(StrToAdd);
   
   InsertLines(2);
   
   // Insert a new table with 9 rows and 4 columns.
   wrdTable = wrdDoc.Tables.Add(wrdSelection.Range,9,4, 
   ref oMissing, ref oMissing);
   // Set the column widths.
   wrdTable.Columns[1].SetWidth(51, Word.WdRulerStyle.wdAdjustNone);
   wrdTable.Columns[2].SetWidth(170, Word.WdRulerStyle.wdAdjustNone);
   wrdTable.Columns[3].SetWidth(100, Word.WdRulerStyle.wdAdjustNone);
   wrdTable.Columns[4].SetWidth(111, Word.WdRulerStyle.wdAdjustNone);
   // Set the shading on the first row to light gray.
   wrdTable.Rows[1].Cells.Shading.BackgroundPatternColorIndex = 
   Word.WdColorIndex.wdGray25;
   // Bold the first row.
   wrdTable.Rows[1].Range.Bold = 1;
   // Center the text in Cell (1,1).
   wrdTable.Cell(1, 1).Range.Paragraphs.Alignment = 
   Word.WdParagraphAlignment.wdAlignParagraphCenter;
   
   // Fill each row of the table with data.
   FillRow(wrdDoc, 1, "Class Number", "Class Name", 
   "Class Time", "Instructor");
   FillRow(wrdDoc, 2, "EE220", "Introduction to Electronics II", 
   "1:00-2:00 M,W,F", "Dr. Jensen");
   FillRow(wrdDoc, 3, "EE230", "Electromagnetic Field Theory I", 
   "10:00-11:30 T,T", "Dr. Crump");
   FillRow( wrdDoc, 4, "EE300", "Feedback Control Systems", 
   "9:00-10:00 M,W,F", "Dr. Murdy");
   FillRow(wrdDoc, 5, "EE325", "Advanced Digital Design", 
   "9:00-10:30 T,T", "Dr. Alley");
   FillRow(wrdDoc, 6, "EE350", "Advanced Communication Systems", 
   "9:00-10:30 T,T", "Dr. Taylor");
   FillRow(wrdDoc, 7, "EE400", "Advanced Microwave Theory", 
   "1:00-2:30 T,T", "Dr. Lee");
   FillRow(wrdDoc, 8, "EE450", "Plasma Theory",
   "1:00-2:00 M,W,F", "Dr. Davis");
   FillRow(wrdDoc, 9, "EE500", "Principles of VLSI Design", 
   "3:00-4:00 M,W,F", "Dr. Ellison");
   
   // Go to the end of the document.
   Object oConst1 = Word.WdGoToItem.wdGoToLine;
   Object oConst2 = Word.WdGoToDirection.wdGoToLast;
   wrdApp.Selection.GoTo(ref oConst1,ref oConst2,ref oMissing,ref oMissing);
   InsertLines(2);
   
   // Create a string and insert it into the document.
   StrToAdd = "For additional information regarding the " +
   "Department of Electrical Engineering, " +
   "you can visit our Web site at ";
   wrdSelection.TypeText(StrToAdd);
   // Insert a hyperlink to the Web page.
   Object oAddress = "http://www.ee.stateu.tld";
   Object oRange = wrdSelection.Range;
   wrdSelection.Hyperlinks.Add(oRange, ref oAddress,ref oMissing,
   ref oMissing, ref oMissing, ref oMissing);
   // Create a string and insert it into the document
   StrToAdd = ".  Thank you for your interest in the classes " +
   "offered in the Department of Electrical " +
   "Engineering.  If you have any other questions, " +
   "please feel free to give us a call at " +
   "555-1212.\r\n\r\n"  +
   "Sincerely,\r\n\r\n" +
   "Kathryn M. Hinsch\r\n" +
   "Department of Electrical Engineering \r\n";
   wrdSelection.TypeText(StrToAdd);
   
   // Perform mail merge.
   wrdMailMerge.Destination = Word.WdMailMergeDestination.wdSendToNewDocument;
   wrdMailMerge.Execute(ref oFalse);
   
   // Close the original form document.
   wrdDoc.Saved = true;
   wrdDoc.Close(ref oFalse,ref oMissing,ref oMissing);
   
   // Release References.
   wrdSelection = null;
   wrdMailMerge = null;
   wrdMergeFields = null;
   wrdDoc = null;
   wrdApp = null;
   
   // Clean up temp file.
   System.IO.File.Delete("C:\\DataDoc.doc");
   } 
   
   

   Hinweis Sie müssen den Code in Visual Studio 2005 ändern. Visual C# fügt dem Projekt standardmäßig ein Formular hinzu, wenn Sie ein Windows Forms Projekt erstellen. Das Formular heißt "Form1". Die beiden Dateien, die das Formular darstellen, heißen "Form1.cs" und "Form1.designer.cs". Sie schreiben den Code in Form1.cs. In der Datei "Form1.designer.cs" schreibt der Windows Forms-Designer den Code, der alle Aktionen implementiert, die Sie durch Ziehen und Ablegen von Steuerelementen aus der Toolbox ausgeführt haben.

   Weitere Informationen zum Windows Forms-Designer in Visual C# 2005 finden Sie auf der folgenden Microsoft Developer Network (MSDN)-Website: Erstellen eines Projekts (Visual C#)Hinweis Microsoft Office Word 2003 hat ein zusätzliches Argument für die Open-Methode des Dokuments. Wenn Sie die Word 2003-PIA verwenden, entfernen Sie die Kommentarnotation für den zusätzlichen Parameter für die Open-Methode.

7. Fügen Sie am Anfang von "Form1.cs" Folgendes hinzu:

   using Word = Microsoft.Office.Interop.Word;
   
   

8. Drücken Sie F5, um das Programm zu erstellen und auszuführen.

9. Klicken Sie auf "Schaltfläche1", um die Word-Automatisierung zu starten und den Seriendruck auszuführen.

References

Weitere Informationen finden Sie auf der folgenden Microsoft Developer Network (MSDN)-Website: Microsoft Office Development with Visual Studio Microsoft Office Development with Visual Studio

Klicken Sie für weitere Informationen auf die folgende Artikelnummer, um den Artikel in der Microsoft Knowledge Base anzuzeigen:

285332 Automatisieren von Word 2002 mit Visual Basic zum Erstellen eines Seriendrucks