How to Add Image in Word Document Using C#

How to Add Image in Word Document Using C#

This tutorial will guide you step-by-step on how to add images to a Word document using C#. We will utilize a command-line application to demonstrate adding an image to a Word document.

Benefits of Adding Images to Word Documents

  1. Enhanced Visual Appeal:
    • Images can make documents more engaging.
  2. Improved Communication:
    • Visuals can help convey complex information more clearly.
  3. Professional Presentation:
    • Including images can enhance the professionalism of your documents.

Prerequisites: Preparing the Environment

  1. Have Visual Studio or any .NET IDE installed.
  2. Ensure the Aspose.Words library is available via NuGet.
  3. Have access to an image file for demonstration purposes.

Step-by-Step Guide to Adding an Image in a Word Document

Step 1: Add Reference to System.Drawing

Ensure that the System.Drawing assembly is referenced in your solution.

Step 2: Add Aspose.Words NuGet Package

Install the Aspose.Words library using the NuGet package manager.

Install-Package Aspose.Words

Step 3: Include Using Directives

Add the necessary using directives at the top of your file.

using Aspose.Words;
using Aspose.Words.Drawing;

Step 4: Create Document Object

Load the Word DOC file into a Document object.

Document addImagesToWordDOC = new Document("input.doc");

Step 5: Create DocumentBuilder Object

Instantiate the DocumentBuilder class to facilitate writing to the document.

DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

Step 6: Move Cursor to Header

Position the cursor to the Primary Header of the Word document.

imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

Step 7: Insert Image in Header

Insert an image into the Word document header.

Shape headerImage = imageWriter.InsertImage("C:\\Add Image in Word Header.jpg");

Step 8: Set Image Properties

Adjust the size and position of the inserted image.

headerImage.Width = 1 * 72; // equals one inch
headerImage.Height = 1 * 72;

Step 9: Add an Image as a Linked File

Move the cursor to the last paragraph and add an image as a link to a file.

imageWriter.MoveTo(addImagesToWordDOC.LastSection.Body.LastParagraph);
Shape imageAsLinkToFile = imageWriter.InsertImage("C:\\Add Image as Link to File.jpg");
imageAsLinkToFile.ImageData.SourceFullName = "C:\\Add Image as Link to File.jpg";

Step 10: Save the Document

Finally, save the modified Word document to disk.

addImagesToWordDOC.Save("C:\\Word with Embedded and Linked Images.docx");

Example Code to Add Images in Word Document

Here’s a complete example that includes all the steps mentioned:

            
// Load Word DOC document that you want to add images to
Document addImagesToWordDOC = new Document("input.doc");

// Instantiate DocumentBuilder class object to write text, images, tables, etc.
DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

// Move cursor to Primary Header in Word DOC
imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

// Insert image in Word document header
Shape headerImage = imageWriter.InsertImage("path-to-header-image.jpeg");

// Set Image Size in Header
headerImage.Width = 1 * 72; // equals to one inch
headerImage.Height = 1 * 72;

// Move cursor to last Paragraph in Word Document
imageWriter.MoveTo(addImagesToWordDOC.LastSection.Body.LastParagraph);

// Add Image to Word Document and Link to File
Shape imageAsLinkToFile = imageWriter.InsertImage("path-to-image.jpeg");
imageAsLinkToFile.ImageData.SourceFullName = "path-to-image.jpeg"
// Save As DOCX
addImagesToWordDOC.Save("images.docx");

Conclusion

This tutorial has shown you how to add images to a Word document using C#. By following these steps, you can include both embedded and linked images, enhancing the aesthetic and informational quality of your Word documents. For further exploration, consider creating Word documents programmatically instead of relying on existing files.

 English