از هدرها و پاورقی ها معمولاً هنگام کار با اسناد Word استفاده می شود. آنها نمای روشنی از موضوع اصلی سند و همچنین هرگونه اطلاعات اضافی که باید در مقابل خوانندگان قرار بگیرند ، ارائه می دهند. Microsoft Word به شما امکان می دهد تا با شخصی سازی اطلاعات هدر و پاورقی را به سند خود اضافه کنید. اگر شما یک توسعه دهنده کاربردی .NET هستید که علاقه مند به توسعه (یا توسعه) برنامه ای برای پردازش اسناد Word است ، افزودن ویژگی درج هدرها و پاورقی ها به اسناد Word از برنامه شما می تواند یک ویژگی مفید باشد. در این مقاله ، ما مراحل اضافه کردن هدر و پاورقی را به یک سند Word از درون یک برنامه .NET انجام خواهیم داد. ما برای این منظور از NPOI API برای .NET در C# استفاده خواهیم کرد.

چگونه می توان با استفاده از Microsoft Word ، هدر و پاورقی را به سند Word وارد کرد؟

قبل از اینکه بتوانیم به بررسی چگونگی اضافه کردن اطلاعات هدر و پاورقی به یک سند Word از یک برنامه .NET بپردازیم ، ابتدا نگاهی بیندازیم که چگونه می توانیم با استفاده از Microsoft Word همان کار را انجام دهیم.

مراحل برای قرار دادن هدر و پاورقی در سند با استفاده از Microsoft Word

می توانید از مراحل زیر برای قرار دادن هدر و پاورقی در یک سند DOCX با استفاده از Microsoft Word استفاده کنید.

  1. insert > header یا پاورقی را انتخاب کنید.
  2. یکی از طرح های داخلی را انتخاب کنید.
  3. متن مورد نظر خود را در هدر یا پاورقی تایپ کنید. 4- هدر و پاورقی را انتخاب کنید.

چگونه می توان هدر و پاورقی را با استفاده از NPOI در C# {.wp-block-heading وارد کرد

اکنون که ما دیده ایم که چگونه می توانیم هدر و پاورقی را در یک سند Word با استفاده از Microsoft Word وارد کنیم ، اجازه دهید نگاهی به نحوه انجام همان کار با استفاده از NPOI API برای .NET در برنامه C# خود بیندازیم. فقط در صورتی که ایده زیادی در مورد NPOI ندارید ، می توانید راهنمای جامع ما را برای [NPOI و دستورالعمل های نصب آن] طی کنید 4.

مراحل برای قرار دادن هدر و پاورقی در سند Word با استفاده از C#

در این مرحله ، ما انتظار داریم که شما یک برنامه ساده کنسول C# ایجاد کرده اید و API NPOI را به آن اضافه کرده اید. از مراحل زیر برای اضافه کردن یک هدر و پاورقی در سند Word با استفاده از NPOI API در C#استفاده کنید.

  1. نمونه ای از کلاس xwpfdocument
  2. مواردی از xwpfparagraph و xwpfrun را برای ایجاد پاراگراف با متن مورد نیاز اضافه کنید
  3. با استفاده از ct_hdr یک هدر ایجاد کنید و ویژگی ها و متن آن را مطابق با کد تنظیم کنید 4- با استفاده از ct_ftr یک پاورقی ایجاد کنید و خصوصیات و متن آن را مطابق با کد تنظیم کنید 5- با استفاده از xwpfrelation روابط منحصر به فرد هدر و پاورقی ایجاد کنید
  4. با استفاده از شیء xwpfdocument پرونده را به دیسک ذخیره کنید
//Create document
XWPFDocument doc = new XWPFDocument();
XWPFParagraph para = doc.CreateParagraph();
XWPFRun run = para.CreateRun();
run.SetText("FileFomrat.com");

doc.Document.body.sectPr = new CT_SectPr();
CT_SectPr secPr = doc.Document.body.sectPr;

//Create header and set its text
CT_Hdr header = new CT_Hdr();
//header.AddNewP().AddNewR().AddNewT().Value = "FileFormat.com";
var headerParagraph = header.AddNewP();
var paragraphRun = headerParagraph.AddNewR();
var paragraphText = paragraphRun.AddNewT();
paragraphText.Value = "FileFormat.com - An Open-source File Format API Guide For Developers";
CT_PPr headerPPR = headerParagraph.AddNewPPr();
CT_Jc headerAlign = headerPPR.AddNewJc();
headerAlign.val = ST_Jc.center;

//Create footer and set its text
CT_Ftr footer = new CT_Ftr();
CT_P footerParagraph = footer.AddNewP();
CT_R ctr = footerParagraph.AddNewR();
CT_Text ctt = ctr.AddNewT();
ctt.Value = "CopyRight (C) 2023";
CT_PPr ppr = footerParagraph.AddNewPPr();
CT_Jc align = ppr.AddNewJc();
align.val = ST_Jc.center;
            
//Create the relation of header
XWPFRelation relation1 = XWPFRelation.HEADER;
XWPFHeader myHeader = (XWPFHeader)doc.CreateRelationship(relation1, XWPFFactory.GetInstance(), doc.HeaderList.Count + 1);

//Create the relation of footer
XWPFRelation relation2 = XWPFRelation.FOOTER;
XWPFFooter myFooter = (XWPFFooter)doc.CreateRelationship(relation2, XWPFFactory.GetInstance(), doc.FooterList.Count + 1);

//Set the header
myHeader.SetHeaderFooter(header);
CT_HdrFtrRef myHeaderRef = secPr.AddNewHeaderReference();
myHeaderRef.type = ST_HdrFtr.@default;
myHeaderRef.id = myHeader.GetXWPFDocument().GetRelationId(myHeader); // = myHeader.GetPackageRelationship().Id;

//Set the footer
myFooter.SetHeaderFooter(footer);
CT_HdrFtrRef myFooterRef = secPr.AddNewFooterReference();
myFooterRef.type = ST_HdrFtr.@default;
myFooterRef.id = myFooter.GetXWPFDocument().GetRelationId(myFooter);//myFooter.GetPackageRelationship().Id;

//Save the file
using (FileStream stream = File.Create("HeaderAndFooter.docx"))
{
    doc.Write(stream);
}

نتیجه گیری

در این مقاله ، ما دیدیم که چگونه می توان یک هدر و پاورقی را به یک سند Word با استفاده از NPOI API در C#اضافه کرد. ما نمونه های بیشتری مانند این را به مقالات آینده خود برای [کار با NPOI API در C# برای پردازش اسناد] اضافه خواهیم کرد. 5. بنابراین با ما همراه باشید.