ایجاد اسناد PDF با استفاده از سی شارپ

تولید و پردازش خودکار اسناد PDF در روزهای اخیر به یک ویژگی درخواستی تبدیل شده است. در برنامه های مختلف، اسناد PDF به صورت پویا مانند فاکتورها، رسیدها و انواع گزارش ها تولید می شوند. مطابق با آن، این مقاله پیاده سازی اساسی اتوماسیون PDF در برنامه های NET را پوشش می دهد. در نهایت، شما یاد خواهید گرفت که چگونه با استفاده از سی شارپ فایل های PDF ایجاد کنید. نمونه کد نحوه درج متن، تصاویر، جداول و سایر اجزاء را در PDF با استفاده از C# نشان می دهد.

C#.NET PDF API - دانلود رایگان

Aspose.PDF for .NET یک API دستکاری فایل PDF است که به شما امکان می دهد فایل های PDF را از داخل برنامه های NET خود تولید و پردازش کنید. با استفاده از API می توانید انواع گزارش ها و اسناد تجاری را به صورت پویا تولید کنید. API به عنوان DLL قابل دانلود و همچنین میزبانی در NuGet در دسترس است.

Install-Package Aspose.Pdf

ایجاد فایل های پی دی اف در سی شارپ

بیایید با ایجاد یک سند PDF ساده که حاوی یک قطعه متن است شروع کنیم. در زیر مراحل ایجاد یک فایل PDF با استفاده از سی شارپ آمده است.

  • یک شی از کلاس Document ایجاد کنید.
  • با استفاده از روش Document.Pages.Add() یک صفحه به سند اضافه کنید.
  • یک شی TextFragment جدید ایجاد کنید و متن آن را تنظیم کنید.
  • TextFragment را به مجموعه Paragraphs صفحه اضافه کنید.
  • فایل PDF را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه ایجاد یک فایل PDF ساده با استفاده از سی شارپ را نشان می دهد.

// مقداردهی اولیه شی سند
Document document = new Document();

// اضافه کردن صفحه
Page page = document.Pages.Add();

// اضافه کردن متن به صفحه جدید
page.Paragraphs.Add(new Aspose.Pdf.Text.TextFragment("Hello World!"));

// PDF را ذخیره کنید 
document.Save("document.pdf");

درباره ایجاد اسناد پیچیده PDF بیشتر بخوانید.

ویرایش یک فایل PDF در سی شارپ

تغییر یک فایل PDF به سادگی ایجاد یک فایل جدید است. به سادگی فایل را با استفاده از کلاس Document بارگیری کنید، عملیات مورد نظر خود را انجام دهید و آن را ذخیره کنید. مراحل زیر برای تغییر یک PDF آمده است.

  • یک شی از کلاس Document ایجاد کنید و مسیر یک فایل PDF را به سازنده آن ارائه دهید.
  • صفحات یا محتوای سند را دستکاری کنید.
  • سند را با استفاده از روش Document.Save() ذخیره کنید.

نمونه کد زیر نحوه تغییر PDF را با استفاده از C# نشان می دهد.

// PDF را بارگیری کنید
var pdfDocument = new Aspose.Pdf.Document("document.pdf");

// دستکاری انجام دهید، به عنوان مثال صفحه خالی جدید اضافه کنید
pdfDocument.Pages.Add();

// PDF به روز شده را ذخیره کنید
pdfDocument.Save(modifiedFileName);

درج تصویر در PDF با استفاده از سی شارپ

بیایید اکنون نحوه درج یک تصویر را در سند PDF بررسی کنیم. در زیر مراحل انجام این کار آمده است.

  • یک شی از کلاس Document برای باز کردن یک سند PDF ایجاد کنید.
  • با استفاده از کلاس Page به صفحه ای که می خواهید تصویری به آن اضافه کنید، دسترسی پیدا کنید.
  • تصویر را به مجموعه منابع صفحه اضافه کنید.
  • از عملگرها برای قرار دادن تصویر در صفحه استفاده کنید:
    • GSave operator to save the current graphical state.
    • ConcatenateMatrix operator to specify where the image is to be placed.
    • انجام دادن operator to draw the image on the page.
    • در نهایت، از عملگر GRestore برای ذخیره وضعیت گرافیکی به روز شده استفاده کنید.
  • فایل PDF را ذخیره کنید.

نمونه کد زیر نحوه افزودن یک تصویر به یک سند PDF را با استفاده از C# نشان می دهد.

// سند را باز کنید
Document pdfDocument = new Document("document.pdf");

// مختصات را تنظیم کنید
int lowerLeftX = 100;
int lowerLeftY = 100;
int upperRightX = 200;
int upperRightY = 200;

// صفحه ای را دریافت کنید که در آن تصویر باید اضافه شود
Page page = pdfDocument.Pages[1];

// بارگذاری تصویر در جریان
FileStream imageStream = new FileStream("aspose-logo.jpg", FileMode.Open);

// تصویر را به مجموعه تصاویر منابع صفحه اضافه کنید
page.Resources.Images.Add(imageStream);

// استفاده از عملگر GSave: این عملگر وضعیت گرافیکی فعلی را ذخیره می کند
page.Contents.Add(new Aspose.Pdf.Operators.GSave());

// اشیاء Rectangle و Matrix ایجاد کنید
Aspose.Pdf.Rectangle rectangle = new Aspose.Pdf.Rectangle(lowerLeftX, lowerLeftY, upperRightX, upperRightY);
Matrix matrix = new Matrix(new double[] { rectangle.URX - rectangle.LLX, 0, 0, rectangle.URY - rectangle.LLY, rectangle.LLX, rectangle.LLY });

// با استفاده از عملگر ConcatenateMatrix (ماتریس پیوست): نحوه قرار دادن تصویر را مشخص می کند
page.Contents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(matrix));
XImage ximage = page.Resources.Images[page.Resources.Images.Count];

// استفاده از عملگر Do: این عملگر تصویر را ترسیم می کند
page.Contents.Add(new Aspose.Pdf.Operators.Do(ximage.Name));

// استفاده از عملگر GRestore: این عملگر حالت گرافیکی را بازیابی می کند
page.Contents.Add(new Aspose.Pdf.Operators.GRestore()); 

// سند به روز شده را ذخیره کنید
pdfDocument.Save("document.pdf");

درباره درج تصاویر در PDF بیشتر بخوانید.

ایجاد جدول در PDF با استفاده از سی شارپ

جداول جزء ضروری اسنادی هستند که برای سازماندهی داده ها در قالب سطر و ستون استفاده می شوند. Aspose.PDF for .NET یک راه کاملاً ساده برای ایجاد و درج جداول در اسناد PDF در اختیار شما قرار می دهد. مراحل زیر برای انجام این عملیات آورده شده است.

  • فایل PDF را با استفاده از کلاس Document بارگیری کنید.
  • یک جدول را راه‌اندازی کنید و ستون‌ها و ردیف‌های آن را با استفاده از کلاس Table تنظیم کنید.
  • تنظیمات جدول (یعنی مرزها) را تنظیم کنید.
  • با ایجاد سطرها با استفاده از روش Table.Rows.Add() جدول را پر کنید.
  • جدول را با استفاده از روش Document.Pages1.Paragraphs.Add(Table) به صفحه اضافه کنید.
  • فایل PDF را ذخیره کنید.

نمونه کد زیر نحوه ایجاد و افزودن جدول در یک سند PDF در سی شارپ را نشان می دهد.

// سند PDF منبع را بارگیری کنید
Aspose.Pdf.Document doc = new Aspose.Pdf.Document("document.pdf");

// نمونه جدیدی از جدول را راه اندازی می کند
Aspose.Pdf.Table table = new Aspose.Pdf.Table();

// رنگ حاشیه جدول را به صورت LightGray تنظیم کنید
table.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, .5f, Aspose.Pdf.Color.FromRgb(System.Drawing.Color.LightGray));

// مرز سلول های جدول را تنظیم کنید
table.DefaultCellBorder = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, .5f, Aspose.Pdf.Color.FromRgb(System.Drawing.Color.LightGray));

// یک حلقه برای اضافه کردن 10 ردیف ایجاد کنید
for (int row_count = 1; row_count < 10; row_count++)
{
    // سطر را به جدول اضافه کنید
    Aspose.Pdf.Row row = table.Rows.Add();
    // سلول های جدول را اضافه کنید
    row.Cells.Add("Column (" + row_count + ", 1)");
    row.Cells.Add("Column (" + row_count + ", 2)");
    row.Cells.Add("Column (" + row_count + ", 3)");
}

// شی جدول را به صفحه اول سند ورودی اضافه کنید
doc.Pages[1].Paragraphs.Add(table);

// سند به روز شده حاوی شی جدول را ذخیره کنید
doc.Save("document_with_table_out.pdf");

درباره ایجاد جداول در PDF بیشتر بخوانید.

ایجاد فرم در PDF در سی شارپ

فرم های موجود در PDF برای جمع آوری داده ها از خوانندگان استفاده می شود. می‌توانید جعبه‌های متن، چک باکس، دکمه‌های رادیویی و سایر کنترل‌های پشتیبانی‌شده را در فرم‌های PDF وارد کنید. فرمت PDF از دو نوع فرم پشتیبانی می کند. فرم‌های آکرو و فرم‌های XFA (به جزئیات مراجعه کنید). در زیر مراحل ایجاد و افزودن فرم ها در PDF آمده است.

  • فایل PDF را با استفاده از کلاس Document بارگیری کنید.
  • کنترل‌های فرم مانند TextBoxField را ایجاد کنید.
  • با استفاده از روش Document.Form.Add(textBoxField, 1)، کنترل را به فرم اضافه کنید.
  • سند PDF را ذخیره کنید.

نمونه کد زیر نحوه افزودن فرم ها به سند PDF را با استفاده از C# نشان می دهد.

// سند را باز کنید
Document pdfDocument = new Document("document.pdf");

// یک فیلد ایجاد کنید
TextBoxField textBoxField = new TextBoxField(pdfDocument.Pages[1], new Aspose.Pdf.Rectangle(100, 200, 300, 300));
textBoxField.PartialName = "textbox1";
textBoxField.Value = "Text Box";

// TextBoxField.Border = حاشیه جدید(
Border border = new Border(textBoxField);
border.Width = 5;
border.Dash = new Dash(1, 1);
textBoxField.Border = border;

textBoxField.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green);

// فیلد را به سند اضافه کنید
pdfDocument.Form.Add(textBoxField, 1);

// PDF اصلاح شده را ذخیره کنید
pdfDocument.Save("output.pdf");

درباره ایجاد فرم ها در PDF بیشتر بخوانید.

نتیجه

در این پست یاد گرفتید که چگونه با استفاده از سی شارپ از ابتدا فایل های پی دی اف بسازید. علاوه بر این، شما با نحوه وارد کردن انواع مختلف اجزاء مانند متن، تصاویر، جداول و فرم ها در یک سند PDF آشنا شده اید. می‌توانید با استفاده از مستندات درباره PDF API اطلاعات بیشتری کسب کنید.

همچنین ببینید

اطلاعات: Aspose یک برنامه وب آنلاین رایگان ارائه می‌کند که به شما امکان می‌دهد فایل‌های PDF را آنلاین مشاهده کنید، برنامه دیگری که به شما امکان می‌دهد فایل‌های PDF را به ویدیو تبدیل کنید، و برنامه‌ای که به شما امکان می‌دهد پی‌دی‌اف‌ها را آنلاین ویرایش کنید ].