عنوان

A quick view of MS Word document transformation.

هدر حاشیه بالای هر صفحه و فوتر حاشیه پایین هر صفحه است. سرصفحه ها و پاورقی ها برای گنجاندن اطلاعاتی که می خواهید در هر صفحه از یک سند نمایش داده شود مانند نام، تاریخ، عنوان سند، شماره صفحه، یا سلب مسئولیت اسناد مفید هستند. هنگام استفاده از MS Word، قابلیت اضافه کردن سرصفحه و پاورقی بر اساس طرح‌بندی‌های از پیش تعریف‌شده را فراهم می‌کند یا به شما امکان می‌دهد تا سرصفحه‌ها و پاورقی‌های سفارشی اضافه کنید. اکثر هدرهای داخلی حاوی مقداری متن مکان‌نما هستند و می‌توانید متن مکان‌نما را نگه دارید یا آن را با فید داده خود جایگزین کنید. همچنین هنگام به‌روزرسانی اطلاعات در قسمت Header یا Footer، محتوای داخل بدنه اصلی سند خاکستری می‌شود که نشان می‌دهد این اشیاء کاملاً از بقیه محتوای صفحه جدا شده‌اند و عملیاتی که روی این اشیاء انجام می‌دهید مختص این قسمت‌ها است. در این مقاله قصد داریم مراحل افزودن یا به روز رسانی هدر فوتر در Word Document با استفاده از REST API را بیاموزیم.

API پردازش کلمه

Aspose.Words Cloud API قابلیت‌های بارگیری فایل‌های MS Word را از فضای ذخیره‌سازی ابری فراهم می‌کند، و همچنین به کاربر اجازه می‌دهد فایل ورودی را مستقیماً در بدنه درخواست ارسال کند و API فایل به‌روزرسانی‌شده را در شی پاسخ برمی‌گرداند. ویژگی های خواندن، افزودن، به روز رسانی یا حذف اشیاء خاص یا تمام سربرگ و پاورقی را فراهم می کند. علاوه بر این، شما همچنین می توانید تعیین کنید که سرصفحه/پانویس های مختلف برای صفحه اول و برای صفحات فرد/ زوج ارائه شود.

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

محدوده مقاله

Aspose.Words Cloud SDK for .NET ما به شما امکان می‌دهد تا به سرعت و به آسانی با [Aspose.Words Cloud REST4 کار کنید، زیرا به جزئیات سطح پایین زیادی در رابطه با درخواست‌ها و رسیدگی به پاسخ‌ها رسیدگی می‌کند و به شما امکان می‌دهد روی نوشتن کد خاص برای نیازهای کسب‌وکارتان تمرکز کنید. در این مقاله قصد داریم از Aspose.Words Cloud SDK for .NET در ویژوال استودیو برای مک استفاده کنیم. در این پست مراحل درج Header Footer در Word Document که در آن قالب بندی سفارشی تعریف می شود را مشخص می کند. سپس قالب بندی محتوای خروجی Footer به روز می شود و اطلاعات PageNumber در موقعیت پایین سمت راست درج می شود. تمام این عملیات در فضای ابری انجام خواهد شد.

نصب و راه اندازی

برای شروع، ابتدا باید ویژوال استودیو را روی سیستم خود نصب کنید. یک نمونه راه حل ایجاد کنید و مرجع NuGet Aspose.Words Cloud SDK for .NET را اضافه کنید. بنابراین برای افزودن یک مرجع، روی راه حل کلیک راست کرده و گزینه منو Manage NuGet Packages… را انتخاب کنید. Aspose.Words-Cloud را در قسمت متن جستجو وارد کنید. گزینه را انتخاب کرده و روی دکمه افزودن بسته کلیک کنید.

اکنون مرجع Aspose.Words.Cloud.Sdk در راه حل ظاهر می شود. استفاده از APIهای ابری در مقایسه با APIهای داخلی (aspose.com) مزایایی دارد. دلیل آن این است که شما نیازی به پیگیری و به روز رسانی نسخه های API به صورت دستی ندارید و نیازی به پرداخت هزینه کل مجوز ندارید.

Aspose.Cloud Dashboard

به سادگی یک حساب در Aspose.Cloud dashboard ایجاد کنید یا از طریق حساب Google یا GitHub موجود خود ثبت نام کنید و شروع به استفاده از API های Cloud ما کنید. یکی دیگر از ویژگی‌های شگفت‌انگیز Cloud API این است که می‌توانید از آن‌ها در هر پلتفرمی با استفاده از هر زبان پشتیبانی‌شده استفاده کنید.

همانطور که در بالا ذکر شد، این مقاله بر گزینه هایی در مورد اضافه کردن و به روز رسانی اشیاء Header و Footer در اسناد MS Word تأکید می کند. به منظور آزمایش، از یک الگوی سند MS Word موجود با نام Business Letter استفاده کرده ایم. سند باید در فضای ذخیره سازی ابری Aspose آپلود شود و تمام دستکاری ها و پردازش اسناد از طریق Cloud انجام می شود. هنگامی که تمام پردازش ها تکمیل شد، می توانیم کپی فایل حاصل را از فضای ذخیره سازی Cloud نیز دانلود کنیم.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

اکنون برای استفاده از API های Aspose.Cloud، باید از App Key و اطلاعات App SID در کد خود استفاده کنید. این کلیدها از اعداد الفبایی تشکیل شده اند. اینها کدهای منحصر به فرد مرتبط با حساب اشتراک شما هستند. برای دریافت این جزئیات، لطفاً روی برگه My Apps در Aspose.Cloud dashboard کلیک کنید. هنگامی که کلیدها را در اختیار داریم، باید شی Aspose.Words API را مقداردهی اولیه کنیم.

string MyAppKey = "f6axxxxxxxxxxxxxxxxxx";     // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

شی Header را درج کنید

برای اضافه کردن شی هدر داخل فایل MS Word، باید عملیات زیر را به ترتیب انجام دهیم.

  1. یک شی از InsertHeaderFooterRequest ایجاد کنید که در آن نوع HeaderFooterLink را به عنوان آرگومان ارسال می کنیم.
  2. با استفاده از روش InsertHeaderFooter (…) شیء HeaderFooterRequest را به شی WordsApi وارد کنید.
  3. یک شی Run ایجاد کنید که اطلاعات متنی نمونه را در خود نگه دارد.
  4. شی InsertRunRequest را ایجاد کنید که در آن مرجع پاراگراف (SectionPath) را در شی HeaderFooter ارسال می کنیم، جایی که متن Run باید اضافه شود.
    سپس متد InsertRun (…) WordsApi را فراخوانی کنید که RunRequest را به شی HeaderFooter اضافه می کند.

HeaderFooter.TypeEnum می تواند یکی از مقادیر زیر باشد.

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// هنگام انتقال اطلاعات AppKey و AppSid یک شی از WordsAPI ایجاد کنید
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// سند نمونه را در فضای ذخیره سازی ابری آپلود کنید
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// درج Header Object در صفحه اول
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);  
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// شی Run حاوی متن نمونه ایجاد کنید
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// متن Run را به پاراگراف اول اولین شی HeaderFooter در بخش اول سند Word اضافه کنید
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// RunRequest را به سند Word وارد کنید
var actual2 = wordsApi.InsertRun(runRequest);
عنوان

Image showing preview of recently added Header

قالب بندی متن سرصفحه جدید درج شده را به روز کنید

هنگامی که شی Header اضافه شد، می توانیم قالب بندی متن محتوای داخل آن را به روز کنیم. برای برآوردن این نیاز، باید مراحل زیر را انجام دهیم.

  1. یک شی از کلاس Font ایجاد کنید، جایی که نام فونت، اندازه، اطلاعات رنگ را مشخص می کنیم.
  2. به منظور ارائه بیشتر متن، ویژگی Engrave را به عنوان True علامت گذاری کنید.
  3. یک شی از کلاس UpdateRunFontRequest ایجاد کنید که در آن فایل ورودی، Font، SectionPath و runIndex را به عنوان آرگومان ارسال می کنیم.
  4. در نهایت، از متد UpdateRunFont(..) استفاده کنید و شی UpdateRunFontRequest را به نمونه WordsApi اضافه کنید.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// هنگام انتقال اطلاعات AppKey و AppSid یک شی از WordsAPI ایجاد کنید
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// سند نمونه را در فضای ذخیره سازی ابری بارگذاری کنید
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// مرحله بعدی تنظیم قالب بندی Header Object است
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
//  قالب بندی متن را به عنوان حکاکی تنظیم کنید
fontDto.Engrave = true;
// قالب بندی را در پاراگراف اول شی HeaderFooter اعمال کنید
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
    fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);
عنوان

Image showing preview of Header after text formatting has been applied.

API همچنین ویژگی به روز رسانی قالب بندی محتوا را در داخل شی Header / Footer موجود ارائه می دهد. برای برآورده کردن این نیاز، می‌توانیم از خطوط کد مشخص شده در بالا استفاده کنیم، اما تنها تفاوت این است که ایندکس headerfooter به 2 تغییر می‌کند. خط کد زیر را ببینید.

// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx", 
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);
عنوان

Image displaying the change in Footer text formatting.

اطلاعات شماره صفحه را در بخش پاورقی اضافه کنید

شماره صفحه اطلاعات بسیار مفیدی مانند صفحه فعلی و تعداد کل صفحات یک سند را ارائه می دهد. مراحل زیر نحوه انجام الزامات را مشخص می کند.

  1. ابتدا یک شی از کلاس PageNumber ایجاد می کنیم که در آن، Alignment of text، فرمت متن، محل رندر اطلاعات PageNumber را تعریف می کنیم و همچنین مشخص می کنیم که آیا PageNumber باید در صفحه اول رندر شود یا خیر.
  2. شی InsertPageNumbersRequest ایجاد کنید و شی PageNumber را به عنوان آرگومان ارسال کنید.
  3. در نهایت، متد InsertPageNumbers(..) را فراخوانی کنید تا InsertPageNumbersRequest را به نمونه WordsApi اضافه کنید.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// هنگام انتقال اطلاعات AppKey و AppSid یک شی از WordsAPI ایجاد کنید
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// سند نمونه را در فضای ذخیره سازی ابری بارگذاری کنید
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// API همچنین ویژگی اضافه کردن جزئیات شماره صفحه در شی HeaderFooter را ارائه می دهد
// اطلاعات شماره صفحه را در سمت راست پایین صفحه اضافه کنید
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// اطلاعات PageNumber را در سند Word درج کنید
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
عنوان

Preview Page number in the footer section.

نتیجه گیری

در این مقاله، مراحل اضافه کردن سرصفحه در سند Word را با استفاده از Aspose.Words Cloud SDK for .NET آموختیم. لطفاً توجه داشته باشید که ما همچنین Cloud SDK برای Java، PHP، Ruby، Python، Go، Swift، C++، Node.Js، Android در دسترس داریم. برای جزئیات بیشتر، لطفاً به Aspose.Words Cloud مراجعه کنید.

مقالات مرتبط

همچنین توصیه می کنیم برای کسب اطلاعات بیشتر به موارد زیر مراجعه کنید