چگونه تصویر را در سند Word با استفاده از C# اضافه کنیم

چگونه تصویر را در سند Word با استفاده از C# اضافه کنیم

این آموزش گام به گام شما را راهنمایی می‌کند که چگونه با استفاده از C# تصاویر را به یک سند Word اضافه کنید. ما از یک برنامه خط فرمان برای نشان دادن افزودن تصویر به یک سند Word استفاده خواهیم کرد.

مزایای افزودن تصاویر به اسناد Word

  1. جذابیت بصری بهبود یافته: - تصاویر می‌توانند اسناد را جذاب‌تر کنند.
  2. ارتباط بهبود یافته: - عناصر بصری می‌توانند اطلاعات پیچیده را واضح‌تر منتقل کنند.
  3. ارائه حرفه‌ای: - گنجاندن تصاویر می‌تواند حرفه‌ای بودن اسناد شما را ارتقا دهد.

پیش‌نیازها: آماده‌سازی محیط

  1. Visual Studio یا هر IDE .NET را نصب کنید.
  2. اطمینان حاصل کنید که کتابخانه Aspose.Words از طریق NuGet در دسترس باشد.
  3. دسترسی به یک فایل تصویر برای اهداف نمایش داشته باشید.

راهنمای گام‌به‌گام برای افزودن تصویر در یک سند Word

مرحله ۱: افزودن ارجاع به System.Drawing

اطمینان حاصل کنید که اسمبلی System.Drawing در راه‌حل شما ارجاع داده شده باشد.

مرحله ۲: افزودن بسته NuGet Aspose.Words

کتابخانه Aspose.Words را با استفاده از مدیر بسته NuGet نصب کنید.

Install-Package Aspose.Words

مرحله 3: افزودن دستورات using

دستورات using لازم را در بالای فایل خود اضافه کنید.

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

مرحله 4: ایجاد شیء Document

Word را بارگذاری کنید target="_blank" rel="noopener"> DOC

فایل را به یک شیء Document بارگذاری کنید.

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

مرحله 5: ایجاد شیء DocumentBuilder

یک نمونه از کلاس DocumentBuilder ایجاد کنید تا نوشتن در سند آسان شود.

DocumentBuilder imageWriter = new DocumentBuilder(addImagesToWordDOC);

مرحله 6: جابجایی مکان‌نما به هدر

مکان‌نما را به هدر اصلی (Primary Header) سند Word موقعیت‌دهی کنید.

imageWriter.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);

مرحله 7: درج تصویر در هدر

یک تصویر را در هدر سند Word درج کنید.

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

مرحله 8: تنظیم ویژگی‌های تصویر

اندازه و موقعیت تصویر درج‌شده را تنظیم کنید.

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

گام 9: افزودن تصویر به‌عنوان فایل پیوندی

مکان‌نمای ماوس را به آخرین پاراگراف منتقل کنید و تصویر را به‌عنوان پیوندی به یک فایل اضافه کنید.

using Aspose.Words;
using Aspose.Words.Drawing;
using System.IO;

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

مرحله ۱۰: ذخیره سند

در نهایت، سند Word اصلاح‌شده را روی دیسک ذخیره کنید.

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

کد نمونه برای افزودن تصاویر در سند Word

در اینجا یک مثال کامل که شامل تمام مراحل ذکر شده است آورده شده است:

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

class Program
{
    static void Main()
    {
        // Load or create a Word document
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);

        // Insert an image
        string imagePath = "image.png";
        builder.InsertImage(imagePath, RelativeHorizontalPosition.Margin, 0, RelativeVerticalPosition.Margin, 0, 200, 100, WrapType.Square);

        // Save the document
        doc.Save("DocumentWithImage.docx");
        Console.WriteLine("Image embedded successfully.");
    }
}

نتیجه‌گیری

این آموزش به شما نشان داده است که چگونه با استفاده از C# تصاویر را به یک سند Word اضافه کنید. با دنبال کردن این مراحل، می‌توانید هر دو نوع تصویر جاسازی‌شده و پیوندی را گنجانده و کیفیت زیبایی‌شناختی و اطلاعاتی اسناد Word خود را ارتقا دهید. برای بررسی‌های بیشتر، به‌جای تکیه بر فایل‌های موجود، ایجاد اسناد Word به‌صورت برنامه‌نویسی‌شده را در نظر بگیرید.

 فارسی