在開(kāi)發(fā)涉及文檔生成的業(yè)務(wù)系統(tǒng)時(shí)，常常需要根據(jù)數(shù)據(jù)動(dòng)態(tài)創(chuàng)建 Word 報(bào)告，并針對(duì)不同場(chǎng)景設(shè)置頁(yè)面布局，如頁(yè)面大?。ˋ4/A3）、方向（縱向/橫向）、頁(yè)邊距等。手動(dòng)調(diào)整大量文檔不僅耗時(shí)，且易出錯(cuò)，因此自動(dòng)化頁(yè)面設(shè)置成為關(guān)鍵需求。

本文基于 Free Spire.Doc for .NET 免費(fèi)庫(kù)，介紹如何通過(guò) C# 代碼實(shí)現(xiàn)對(duì) Word 文檔頁(yè)面的靈活控制，包括設(shè)置頁(yè)面尺寸、方向、邊距，以及在同一文檔中使用多個(gè)不同布局的節(jié)（Section），希望能為有排版需求的開(kāi)發(fā)者提供參考。

準(zhǔn)備工作：裝上 NuGet 包

在 Visual Studio 里新建一個(gè) .NET 控制臺(tái)項(xiàng)目（或者 ASP.NET Core 項(xiàng)目也行），然后通過(guò) NuGet 安裝：

Install-Package FreeSpire.Doc

安裝完后，在代碼文件開(kāi)頭加上：

using Spire.Doc;
using Spire.Doc.Documents;

基本操作：創(chuàng)建文檔和節(jié)（Section）

Word 文檔的結(jié)構(gòu)是：Document → Section → 段落/表格等。頁(yè)面設(shè)置是針對(duì)每個(gè) Section 的，所以要先拿到 Section 對(duì)象。

// 創(chuàng)建 Document 對(duì)象
Document document = new Document();

// 添加一個(gè)節(jié)（Section）
Section section = document.AddSection();

如果你不手動(dòng)添加 Section，document 默認(rèn)也會(huì)自帶一個(gè)，但顯式添加更清晰。

設(shè)置頁(yè)面大小：A4、A3、Letter 還是自定義？

頁(yè)面大小可以通過(guò) PageSetup.PageSize 來(lái)設(shè)置。PageSize 是一個(gè) SizeF 結(jié)構(gòu)，單位是點(diǎn)（point），1 英寸 = 72 點(diǎn)。Free Spire.Doc 提供了幾個(gè)預(yù)定義的頁(yè)面大小常量，比如：

• PageSize.A4：寬 595 點(diǎn)，高 842 點(diǎn)（對(duì)應(yīng) 210mm × 297mm）
• PageSize.Letter：寬 612 點(diǎn)，高 792 點(diǎn)
• PageSize.A3：寬 842 點(diǎn)，高 1191 點(diǎn)

用法很簡(jiǎn)單：

// 設(shè)置為 A4
section.PageSetup.PageSize = PageSize.A4;

// 如果要自定義大小，比如 10cm × 15cm（需要換算成點(diǎn)）
float width = 10 * 72 / 2.54f;    // 10 厘米轉(zhuǎn)英寸再轉(zhuǎn)點(diǎn)
float height = 15 * 72 / 2.54f;
section.PageSetup.PageSize = new SizeF(width, height);

自定義尺寸：

如果你需要精確的毫米/厘米，記得用 厘米數(shù) * 72 / 2.54 這個(gè)公式，切記單位是點(diǎn)。

設(shè)置頁(yè)面方向：縱向還是橫向？

方向設(shè)置很簡(jiǎn)單，通過(guò) PageSetup.Orientation 屬性：

// 縱向
section.PageSetup.Orientation = PageOrientation.Portrait;

// 橫向
section.PageSetup.Orientation = PageOrientation.Landscape;

注意：當(dāng)你設(shè)置方向?yàn)闄M向時(shí)，最好先設(shè)置頁(yè)面大小。因?yàn)槿绻仍O(shè)置橫向再設(shè)置頁(yè)面大小，頁(yè)面大小可能會(huì)被重置（取決于內(nèi)部實(shí)現(xiàn)），因此建議先 PageSize 再 Orientation。

設(shè)置頁(yè)邊距：上、下、左、右

頁(yè)邊距也是通過(guò) PageSetup 來(lái)設(shè)置，單位同樣是點(diǎn)：

section.PageSetup.Margins.Top = 72f;       // 上邊距 1 英寸
section.PageSetup.Margins.Bottom = 72f;    // 下邊距 1 英寸
section.PageSetup.Margins.Left = 90f;       // 左邊距 1.25 英寸（方便裝訂）
section.PageSetup.Margins.Right = 72f;      // 右邊距 1 英寸

當(dāng)然也可以用厘米換算，比如設(shè)置 2.54cm 邊距：2.54 * 72 / 2.54 = 72，正好 1 英寸。

完整示例：動(dòng)態(tài)生成一個(gè)橫向 A3 文檔

下面是一個(gè)完整的小例子，創(chuàng)建一個(gè)橫向的 A3 文檔，頁(yè)邊距上下左右都是 1 厘米，并添加一段文字說(shuō)明：

using Spire.Doc;
using Spire.Doc.Documents;
using System.Drawing;

class Program
{
    static void Main(string[] args)
    {
        // 創(chuàng)建文檔
        Document document = new Document();
        Section section = document.AddSection();

        // 設(shè)置頁(yè)面大小為 A3
        section.PageSetup.PageSize = PageSize.A3;
        
        // 設(shè)置方向?yàn)闄M向
        section.PageSetup.Orientation = PageOrientation.Landscape;

        // 設(shè)置頁(yè)邊距（1 厘米 = 28.35 點(diǎn)）
        float marginInPoints = 28.35f; // 1cm
        section.PageSetup.Margins.All = marginInPoints; // 或者分別設(shè)置 Top/Bottom/Left/Right

        // 添加一個(gè)段落
        Paragraph para = section.AddParagraph();
        para.AppendText("這是一個(gè)橫向的 A3 文檔，頁(yè)邊距均為 1 厘米。");
        para.ApplyStyle(BuiltinStyle.Heading1);

        // 保存文檔
        document.SaveToFile("TestA3.docx", FileFormat.Docx);
        System.Diagnostics.Process.Start("TestA3.docx"); // 打開(kāi)看看效果
    }
}

運(yùn)行之后，生成的 Word 文檔就會(huì)按我們的要求排版。

進(jìn)階：不同節(jié)設(shè)置不同頁(yè)面

有時(shí)候一個(gè)文檔里需要既有縱向頁(yè)面，又有橫向頁(yè)面（比如報(bào)告里夾一張大表格）。這時(shí)候可以用多個(gè) Section，每個(gè) Section 可以獨(dú)立設(shè)置頁(yè)面布局。

Document document = new Document();

// 第一節(jié)：縱向 A4
Section section1 = document.AddSection();
section1.PageSetup.PageSize = PageSize.A4;
section1.PageSetup.Orientation = PageOrientation.Portrait;
section1.AddParagraph().AppendText("這是縱向 A4 頁(yè)面的內(nèi)容。");

// 第二節(jié)：橫向 A3
Section section2 = document.AddSection();
section2.PageSetup.PageSize = PageSize.A3;
section2.PageSetup.Orientation = PageOrientation.Landscape;
section2.AddParagraph().AppendText("這是橫向 A3 頁(yè)面的內(nèi)容。");

document.SaveToFile("MultiSection.docx", FileFormat.Docx);

這樣生成的 Word 文檔里，第一節(jié)是縱向 A4，第二節(jié)會(huì)自動(dòng)另起一頁(yè)并變成橫向 A3。這個(gè)特性在生成復(fù)雜報(bào)告時(shí)特別有用。

注意事項(xiàng)

單位問(wèn)題：所有尺寸都是點(diǎn)（point），不是像素，也不是厘米/毫米。換算公式：1 英寸 = 72 點(diǎn) = 2.54 厘米。所以我一般先定義幾個(gè)常量：

const float PointsPerInch = 72;
const float CmPerInch = 2.54f;
// 厘米轉(zhuǎn)點(diǎn)
float CmToPoints(float cm) => cm * PointsPerInch / CmPerInch;

頁(yè)邊距設(shè)置順序：如果同時(shí)設(shè)置了 PageSize 和 Margins，順序無(wú)所謂。但如果你先設(shè)置 Margins 再設(shè)置 PageSize，Margins 的值不會(huì)因?yàn)轫?yè)面大小改變而自動(dòng)調(diào)整，所以放心。

免費(fèi)版的限制：Free Spire.Doc 有少量限制（比如最多 500 個(gè)段落、表格等），但一般日常使用足夠了。

保存格式：用 SaveToFile 時(shí)最好明確指定 FileFormat.Docx，避免保存成舊版 .doc 導(dǎo)致格式丟失。

總結(jié)

通過(guò)以上簡(jiǎn)單代碼，可以快速實(shí)現(xiàn) Word 文檔頁(yè)面的自動(dòng)化設(shè)置，替代手動(dòng)操作，提升開(kāi)發(fā)效率。頁(yè)面設(shè)置的核心單位是「磅（Point）」，需注意與厘米 / 毫米的轉(zhuǎn)換。多節(jié)文檔需遍歷每個(gè)節(jié)單獨(dú)配置，確保所有頁(yè)面格式統(tǒng)一或按需差異化。

到此這篇關(guān)于C#代碼實(shí)現(xiàn)設(shè)置Word文檔頁(yè)面(頁(yè)面大小、邊距、方向)的文章就介紹到這了,更多相關(guān)C#設(shè)置Word頁(yè)面內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論