Header und Fußzeilen werden häufig bei der Arbeit mit Wortdokumenten verwendet. Sie geben ein klares Überblick über das Hauptthema des Dokuments sowie zusätzliche Informationen, die vor den Lesern gestellt werden müssen. Mit Microsoft Word können Sie mit Anpassung Header- und Fußzeile in Ihrem Dokument hinzufügen. Wenn Sie ein .NET -Anwendungsentwickler sind, der an der Entwicklung einer Anwendung für die Verarbeitung von Word -Dokumenten interessiert ist (oder entwickelt), kann das Hinzufügen der Funktionen des Einfügen von Headern und Fußzeilen in Word -Dokumente aus Ihrer Anwendung eine vorteilhafte Funktion sein. In diesem Artikel werden wir die Schritte durchlaufen, um einem Word -Dokument aus einer .NET -Anwendung Header und Fußzeile hinzuzufügen. Für diesen Zweck verwenden wir die NPOI -API für .NET in C# .

Wie ich mit Microsoft Word Header und Fußzeile in das Wort einfügt?

Bevor wir uns untersuchen können, wie Sie einen Word -Dokument von einer .NET -Anwendung zu Header- und Fußzeile hinzufügen können, schauen wir uns zunächst an, wie wir mit Microsoft Word dasselbe tun können.

Schritte zum Einfügen von Header und Fußzeile in Dokument mit Microsoft Word

Sie können die folgenden Schritte verwenden, um Header und Fußzeile in einem DOCX -Dokument mit Microsoft Word einzulegen.

  1. Wählen Sie einfügen > Header oder Fußzeile .
  2. Wählen Sie eines der integrierten Designs aus.
  3. Geben Sie den gewünschten Text in die Header oder Fußzeile ein.
  4. Wählen Sie Header und Fußzeile , wenn Sie fertig sind.

So fügen Sie Header und Fußzeile mit NPOI in C# {.wp-Block-Heading} ein

Nachdem wir gesehen haben, wie Sie Header und Fußzeile mit Microsoft Word in ein Word -Dokument einfügen, schauen wir uns an, wie Sie die gleiche NPOI -API für .NET in unserer C# -Anwendung tun. Nur für den Fall, dass Sie nicht viel Vorstellung von NPOI haben, können Sie unseren umfassenden Leitfaden für NPOI und seine Installationsrichtlinien durchlaufen.

Schritte zum Einfügen von Header und Fußzeile in Word-Dokument mit C#

In dieser Phase erwarten wir, dass Sie eine einfache C# -Konsole -Anwendung erstellt und NPOI -API hinzugefügt haben. Verwenden Sie die folgenden Schritte, um eine Header und eine Fußzeile im Word -Dokument mit der NPOI -API in C#hinzuzufügen.

  1. Erstellen Sie eine Instanz von xwpfdocument Klasse
  2. Fügen Sie Instanzen von xwpf -Abschnitt und xwpfrun hinzu, um einen Absatz mit dem erforderlichen Text zu erstellen
  3. Erstellen Sie einen Header mit ct_hdr und setzen Sie seine Eigenschaften und seinen Text wie im Code gezeigt
  4. Erstellen Sie eine Fußzeile mit ct_ftr und setzen Sie seine Eigenschaften und seinen Text wie im Code gezeigt
  5. Erstellen Sie einzigartige Beziehungen von Header und Fußzeile mit xwpfrelation
  6. Speichern Sie die Datei mit dem xWPFDocument -Objekt in der CD mit dem Objekt**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);
}

Schlussfolgerung

In diesem Artikel haben wir gesehen, wie man einem Word -Dokument mit der NPOI -API in C#einen Header und Fußzeile hinzufügt. Wir werden unseren zukünftigen Artikeln für Arbeiten mit NPOI -API in C# für die Dokumentverarbeitung weitere Beispiele wie diese hinzufügen. Also bleibt gespannt.