ヘッダーとフッターは、単語文書の使用中に一般的に使用されます。彼らは、ドキュメントの主なテーマと、読者の前に置く必要がある追加情報を明確に見ています。 Microsoft Wordでは、カスタマイズによりドキュメントにヘッダー情報とフッター情報を追加できます。 Word Document処理のアプリケーションの開発に関心がある（または開発した）.NETアプリケーション開発者である場合、アプリケーションからWordドキュメントにヘッダーとフッターを挿入する機能が有益な機能になる可能性があります。 この記事では、.NETアプリケーション内からヘッダーとフッターをWordドキュメントに追加する手順を実行します。この目的のために、 c# で.netのnpoi APIを使用します。

MicrosoftWordを使用して、ヘッダーとフッターをWordドキュメントに挿入する方法は？

.NETアプリケーションからWordドキュメントにヘッダーとフッター情報を追加する方法を検討する前に、まずMicrosoft Wordを使用して同じことを行う方法を見てみましょう。

Microsoft Wordを使用してドキュメントにヘッダーとフッターを挿入する手順

次の手順を使用して、Microsoft Wordを使用してdocxドキュメントにヘッダーとフッターを挿入できます。

  1. 挿入 > ヘッダー または フッター を選択します。 2.ビルトインデザインのいずれかを選択します。 3.ヘッダーまたはフッターに必要なテキストを入力します。
  2. [完了したら、**ヘッダーとフッターを閉じる]を選択します。

c#

Microsoft Wordを使用してWordドキュメントにヘッダーとフッターを挿入する方法が見られたので、C#アプリケーションで.NETのNPOI APIを使用して同じことを行う方法を見てみましょう。 NPOIについてあまり考えない場合に備えて、[NPOIとそのインストールガイドライン]の包括的なガイドを確認できます4。

c#{.wp-block-heading}を使用して、単語文書にヘッダーとフッターを挿入する手順}

この段階では、簡単なC#コンソールアプリケーションを作成し、NPOI APIを追加したと予想されます。次の手順を使用して、C#でNPOI APIを使用して、Wordドキュメントにヘッダーとフッターを追加します。

  1. xwpfdocument クラスのインスタンスを作成します
  2. xwpfparagraph および xwpfrun のインスタンスを追加して、必要なテキストを含む段落を作成します
  3. ct_hdr を使用してヘッダーを作成し、コードに示すようにそのプロパティとテキストを設定します
  4. ct_ftr を使用してフッターを作成し、コードに示すようにそのプロパティとテキストを設定します
  5. XWPFRELATION を使用して、ヘッダーとフッターのユニークな関係を作成する
  6. 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);
}

結論

この記事では、C#でNPOI APIを使用して、Wordドキュメントにヘッダーとフッターを追加する方法を見ました。これらのような例を将来の記事に追加しますドキュメント処理のためにC#でNPOI APIを使用。だから、ご期待ください。