Add Headers and Footers in PDF using C#

Header و footer بخش‌ها در یک سند اطلاعات سند را نشان می‌دهند، مانند عنوان سند، لوگو، عنوان فصل، شماره صفحات و غیره. ما می‌توانیم هر متنی یا تصویری را به صورت برنامه‌نویسی در header/footer های سند PDF اضافه کنیم. در این مقاله، ما یاد می‌گیریم که چگونه می‌توان header و footer را در اسناد PDF با استفاده از C# اضافه کرد.

مباحث زیر در این مقاله مورد بحث قرار خواهند گرفت:

API C# برای افزودن هدرها و فوترها در اسناد PDF

برای افزودن هدر و فوتر به فایل‌های PDF، ما از Aspose.PDF for .NET API استفاده خواهیم کرد. این به ما اجازه می‌دهد که سندهای پشتیبانی شده را بدون استفاده از Adobe Acrobat تولید، اصلاح، تبدیل، رندر، ایمن و چاپ کنیم. لطفاً DLL این API را دانلود کنید یا آن را با استفاده از NuGet نصب کنید.

Install-Package Aspose.PDF

Add Text in Header of PDF using C#

ما می‌توانیم با دنبال کردن مراحل زیر، متن را در بالای یک سند PDF موجود اضافه کنیم:

  1. Firstly, load a PDF document using the Document class with input file path as an argument. It is the main class that represents a PDF document and allows performing various functionalities.
  2. در مرحله بعد، یک نمونه از کلاس TextStamp ایجاد کنید تا متنی را در سرصفحه سند نمایش دهد.
  3. سپس ویژگی‌های مختلفی مانند TopMargin، HorizontalAlignment و VerticalAlignment را به صورت Top و غیره تنظیم کنید.
  4. اختیاری است که ForegroundColor، Font، FontStyle، FontSize، BackgroundColor، RotateAngle و سطح Zoom را برای متن تنظیم کنید.
  5. پس از آن، از طریق تمام صفحات حلقه بزنید و هدر را با استفاده از Page.AddStamp() متد با شیء TextStamp اضافه کنید.
  6. در نهایت، متد Document.Save() را با مسیر فایل خروجی به عنوان یک آرگومان فراخوانی کنید تا فایل خروجی را ذخیره کنید.

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

// این مثال کد نشان می‌دهد که چگونه می‌توان متن را به هدر یک سند PDF موجود اضافه کرد.
// بارگذاری سند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Create header
TextStamp textStamp = new TextStamp("Header Text");

// خصوصیات مهر را تنظیم کنید
textStamp.TopMargin = 10;
textStamp.HorizontalAlignment = HorizontalAlignment.Center;
textStamp.VerticalAlignment = VerticalAlignment.Top;

// Specify the font style
textStamp.TextState.FontStyle = FontStyles.Bold;
textStamp.TextState.ForegroundColor = Color.Red;
textStamp.TextState.FontSize = 14;
textStamp.TextState.BackgroundColor = Color.Pink;
textStamp.TextState.Font = FontRepository.FindFont("Verdana");

// Add header on all pages
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(textStamp);
}

// سند به‌روز شده را ذخیره کنید
pdfDocument.Save(@"C:\Files\output.pdf");
متن را در هدر PDF با استفاده از C# اضافه کنید.

Add Text in Header of PDF using C#.

ما می‌توانیم به صورت برنامه‌نویسی متن را در پاورقی اسناد PDF اضافه کنیم با دنبال کردن مراحل ذکر شده قبلی. با این حال، ما نیاز داریم که BottomMargin و VerticalAlignment را به Bottom تنظیم کنیم تا متن در پاورقی نمایش داده شود.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان متن را در پاورقی یک سند PDF با استفاده از C# اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان متن را به پاورقی یک سند PDF موجود اضافه کرد.
// بارگزاری سند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Create footer
TextStamp textStamp = new TextStamp("Footer Text");

// ویژگی‌های مهر را تنظیم کنید
textStamp.BottomMargin = 10;
textStamp.HorizontalAlignment = HorizontalAlignment.Center;
textStamp.VerticalAlignment = VerticalAlignment.Bottom;

// اضافه کردن پاورقی در تمام صفحات
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(textStamp);
}

// مدرک به روز شده را ذخیره کنید
pdfDocument.Save(@"C:\Files\output.pdf");
متن را در فوتر PDF با استفاده از C# اضافه کنید.

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

تصویر را در سربرگ PDF با استفاده از C# вставить

ما می‌توانیم همچنین یک تصویر به هدر یک سند PDF موجود اضافه کنیم با دنبال کردن مراحل زیر:

  1. ابتدا، یک سند PDF را با استفاده از کلاس Document با مسیر فایل ورودی به عنوان آرگومان بارگذاری کنید.
  2. Next, create an instance of the ImageStamp class with image file path as an argument.
  3. سپس ویژگی‌های مختلفی مانند TopMargin، HorizontalAlignment و VerticalAlignment را به صورت Top و غیره تنظیم کنید.
  4. پس از آن، به تمام صفحات بگردید و هدر را با استفاده از Page.AddStamp() روش با شیء ImageStamp اضافه کنید.
  5. در نهایت، با مسیر فایل خروجی به عنوان آرگومان، متد Document.Save() را برای ذخیره فایل خروجی فراخوانی کنید.

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

// این مثال کد نشان می‌دهد که چگونه می‌توان یک تصویر را به هدر یک سند PDF موجود اضافه کرد.
// بارگذاری سند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Create header
ImageStamp imageStamp = new ImageStamp(@"C:\Files\conholdate-logo.jpg");

// خصوصیات مهر را تنظیم کنید
imageStamp.TopMargin = 10;
imageStamp.HorizontalAlignment = HorizontalAlignment.Center;
imageStamp.VerticalAlignment = VerticalAlignment.Top;

// Add header on all pages
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(imageStamp);
}

// سند به روز شده را ذخیره کنید
pdfDocument.Save(@"C:\Files\output.pdf");
تصویر را در سرصفحه PDF با استفاده از C# وارد کنید.

درج تصویر در هدر PDF با استفاده از C# .

ما می‌توانیم به صورت برنامه‌نویسی تصاویر را در پاورقی اسناد PDF اضافه کنیم با پیروی از مراحل ذکر شده در بالا. با این حال، نیاز است که BottomMargin و VerticalAlignment را به عنوان Bottom تنظیم کنیم تا تصویر در پاورقی نمایش داده شود.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان یک تصویر را در پاورقی یک سند PDF با استفاده از C# اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان یک تصویر را در پاورقی یک سند PDF موجود اضافه کرد.
// بارگذاری سند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Create footer
ImageStamp imageStamp = new ImageStamp(@"C:\Files\conholdate-logo.jpg");

// خصوصیات مهر را تعیین کنید
imageStamp.BottomMargin = 10;
imageStamp.HorizontalAlignment = HorizontalAlignment.Center;
imageStamp.VerticalAlignment = VerticalAlignment.Bottom;

// در همه صفحات فوتر اضافه کنید
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(imageStamp);
}

// مدرک به‌روزرسانی‌شده را ذخیره کنید
pdfDocument.Save(@"C:\Files\output.pdf");
درج تصویر در پاورقی PDF با استفاده از C#.

درج تصویر در پاورقی PDF با استفاده از C#.

Add Different Headers and Footers on Different Pages

ما می‌توانیم هدرها/فوترهای مختلفی را برای صفحات مختلف در یک سند PDF واحد با دنبال کردن مراحل زیر اضافه کنیم:

  1. ابتدا، یک سند PDF را با استفاده از کلاس Document با مسیر فایل ورودی به عنوان آرگومان بارگذاری کنید.
  2. در مرحله بعد، چندین نمونه از کلاس ImageStamp با مسیر فایل تصویر و/یا کلاس TextStamp با متنی که قرار است نمایش داده شود، ایجاد کنید.
  3. سپس مشخصات مختلفی مانند TopMargin، HorizontalAlignment و VerticalAlignment را به عنوان Top برای سربرگ و BottomMargin و VerticalAlignment را به عنوان Bottom برای پاورقی تنظیم کنید.
  4. بعد از آن، هدر یا پاورقی را با استفاده از Page.AddStamp() متد با شیء ImageStamp یا TextStamp برای یک صفحه اضافه کنید.
  5. در نهایت، با مسیر فایل خروجی به عنوان آرگومان، متد Document.Save() را برای ذخیره فایل خروجی فراخوانی کنید.

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

// این نمونه کد نشان می‌دهد که چگونه می‌توان هدرهای مختلفی را برای صفحات مختلف در یک سند PDF واحد اضافه کرد.
// بارگذاری سند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// Create three stamps
ImageStamp stamp1 = new ImageStamp(@"C:\Files\PDF\conholdate-logo.jpg");
TextStamp stamp2 = new TextStamp("Header Stamp 2");
TextStamp stamp3 = new TextStamp("Header Stamp 3");

// تنظیم هم‌راستایی مهر برای stamp1
stamp1.VerticalAlignment = VerticalAlignment.Top;
stamp1.HorizontalAlignment = HorizontalAlignment.Center;

// تنظیم تراز مهر برای stamp2
stamp2.VerticalAlignment = VerticalAlignment.Top;
// تنظیم اطلاعات تراز افقی برای مهر به عنوان تراز مرکز
stamp2.HorizontalAlignment = HorizontalAlignment.Center;
// متغیر زوم برای شیء تمبر را تنظیم کنید
stamp2.Zoom = 10;

// تنظیم تراز برچسب برای stamp3
stamp3.VerticalAlignment = VerticalAlignment.Top;
// تنظیم اطلاعات تراز افقی برای شیء مهر به عنوان تراز مرکز
stamp3.HorizontalAlignment = HorizontalAlignment.Center;
// زاویه چرخش برای شیء مهر را تنظیم کنید
stamp3.RotateAngle = 35;


// Add first stamp on first page;
pdfDocument.Pages[1].AddStamp(stamp1);

// Add second stamp on second page;
pdfDocument.Pages[2].AddStamp(stamp2);

// Add third stamp on third page.
pdfDocument.Pages[3].AddStamp(stamp3);

// مدرک به‌روز شده را ذخیره کنید
pdfDocument.Save(@"C:\Files\output.pdf");

ما می‌توانیم شماره صفحه‌ها را در بخش پاورقی اسناد PDF با دنبال کردن مراحل زیر اضافه کنیم:

  1. ابتدا، یک سند PDF را با استفاده از کلاس Document با مسیر فایل ورودی به عنوان آرگومان بارگذاری کنید.
  2. سپس، کارهای زیر را برای هر صفحه در مجموعه Document.Pages انجام دهید.
    • یک نمونه از کلاس TextStamp با متنی که با شماره صفحه فعلی ترکیب شده است ایجاد کنید.
    • سپس ویژگی‌های مختلفی مانند BottomMargin، HorizontalAlignment و VerticalAlignment را به عنوان Bottom و غیره تنظیم کنید.
    • پس از آن، روش Page.AddStamp() را با شیء TextStamp فراخوانی کنید تا شماره صفحه را در پاورقی اضافه کنید.
  3. در نهایت، متد Document.Save() را با مسیر فایل خروجی به عنوان آرگومان فراخوانی کنید تا فایل خروجی را ذخیره کنید.

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

// این مثال کد نشان می‌دهد که چگونه شماره صفحه را در پاورقی هر صفحه از یک سند PDF اضافه کنید. 
// بارگذاری سند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// در تمام صفحات فوتر اضافه کنید
foreach (Page page in pdfDocument.Pages)
{
    // Create footer
    TextStamp textStamp = new TextStamp("Page " + page.Number + " of " + pdfDocument.Pages.Count + " pages.");
    
    // خصوصیات مهر را تنظیم کنید
    textStamp.BottomMargin = 10;
    textStamp.HorizontalAlignment = HorizontalAlignment.Center;
    textStamp.VerticalAlignment = VerticalAlignment.Bottom;

    // Add stamp
    page.AddStamp(textStamp);
}

// Save the updated document
pdfDocument.Save(@"C:\Files\PDF\output.pdf");
شماره صفحه ها را در پاورقی اضافه کنید.

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

مجوز API رایگان بگیرید

شما می‌توانید بدون محدودیت‌های ارزیابی، API را با درخواست یک مجوز موقت رایگان امتحان کنید.

نتیجه‌گیری

در این مقاله، ما یاد گرفته‌ایم که چگونه می‌توانیم یک متن یا یک تصویر در سرصفحه‌ها/پاورقی‌های فایل‌های PDF موجود با استفاده از C# اضافه کنیم. همچنین دیده‌ایم که چگونه می‌توانیم سرصفحه‌های مختلفی را در صفحات مختلف یک سند PDF اضافه کنیم و چگونه می‌توانیم شماره صفحه‌ای را در پاورقی یک سند اضافه کنیم. علاوه بر این، می‌توانید در مورد Aspose.PDF برای .NET API اطلاعات بیشتری با استفاده از documentation یاد بگیرید. در صورت هر گونه ابهام، لطفاً احساس رایگان کنید که با ما در forum تماس بگیرید.

به همچنین نگاه کنید