Cách làm việc với Sections trong .NET

Bước 1: Cài đặt gói

Aspose.Words FOSS cho .NET hiện chưa phát hành gói NuGet – hãy build thư viện từ source thay thế. Clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git, sau đó build Aspose.Words.sln trong cấu hình Release bằng SDK .NET và tham chiếu tới assembly Aspose.Words kết quả từ dự án của bạn. Thư viện nhắm tới .NET Standard 2.0, vì vậy nó chạy trên .NET Framework 4.6.2+ và .NET 6/8/10.

Bước 2: Nhập các lớp cần thiết

Thêm một chỉ thị using Aspose.Words; – Section, PageSetup, HeaderFooter, và các enum liên quan được sử dụng trong hướng dẫn này đều nằm trực tiếp trong không gian tên Aspose.Words cùng với Document và DocumentBuilder.

Bước 3: Đọc các Phần đã có trong tài liệu

Document.Sections trả về một SectionCollection giữ mọi Section trong tài liệu, mỗi CompositeNode cũng là một phần của cây nút tổng thể. Document.FirstSection và Document.LastSection cung cấp quyền truy cập trực tiếp tới các phần biên giới mà không cần duyệt qua bộ sưu tập. Mỗi Section chứa một Body — được tiếp cận theo cùng cách như bất kỳ Story nào khác — và, nếu có, nội dung tiêu đề và chân trang được truy cập qua Section.HeadersFooters.

Bước 4: Bắt đầu một Phần mới với Dấu ngắt Phần

Call DocumentBuilder.InsertBreak(BreakType) tại con trỏ để bắt đầu một đoạn mới. Truyền BreakType.SectionBreakNewPage khi đoạn mới luôn phải bắt đầu trên một trang mới, BreakType.SectionBreakContinuous khi chỉ cần thay đổi thiết lập trang (ví dụ, chuyển sang văn bản đa cột) mà không ép buộc ngắt trang, hoặc BreakType.SectionBreakNewColumn, SectionBreakEvenPage, và SectionBreakOddPage cho các hành vi bắt đầu phần khác mà Word hỗ trợ. Một ngắt phần mang định dạng cho phần mà follows nó, vì vậy hãy đặt PageSetup các thuộc tính trên phần mới Section – không phải phần trước đó – ngay khi ngắt được chèn vào. DocumentBuilder.MoveToSection(sectionIndex) di chuyển con trỏ đến đầu phần thân cụ thể, và PageSetup.SectionStart đọc hoặc đặt SectionStart loại ngắt đã được ghi lại trên một phần hiện có.

Bước 5: Cấu hình Kích thước Trang và Lề

Mỗi Section.PageSetup là một thể hiện PageSetup. Đặt PageWidth, PageHeight, LeftMargin, RightMargin, TopMargin, BottomMargin và Gutter cho kích thước trang và lề, hoặc gán một cài đặt trước Margins trực tiếp cho PageSetup.Margins. Orientation và PaperSize kiểm soát hướng trang và kích thước giấy. Viền trang được cấu hình bằng Borders (một BorderCollection), BorderAppliesTo (PageBorderAppliesTo), BorderDistanceFrom (PageBorderDistanceFrom), BorderAlwaysInFront, BorderSurroundsHeader và BorderSurroundsFooter. Gọi PageSetup.ClearFormatting() để đặt lại cài đặt trang của một phần về mặc định trước khi cấu hình lại từ đầu.

Bước 6: Thêm và Liên kết Tiêu đề và Chân trang

Section.HeadersFooters là một HeaderFooterCollection với các accessor có kiểu – HeaderPrimary, HeaderFirst, HeaderEven, FooterPrimary, FooterFirst, FooterEven – cùng với GetByHeaderFooterType() để tra cứu bởi HeaderFooterType và Add() nhằm thêm một mục mới. Mỗi HeaderFooter là một Story, được đánh dấu IsHeader và IsLinkedToPrevious. Kích hoạt PageSetup.DifferentFirstPageHeaderFooter hoặc PageSetup.OddAndEvenPagesHeaderFooter trước khi thêm biến thể tương ứng HeaderFirst/FooterFirst hoặc HeaderEven/FooterEven — cờ và biến thể chỉ có hiệu lực khi cùng xuất hiện. Gọi HeaderFooterCollection.LinkToPrevious() để kết nối lại tiêu đề hoặc chân trang của một phần để kế thừa nội dung của phần trước, hoặc để tách nó ra sao cho phần mới bắt đầu với nội dung độc lập.

Bước 7: Bố trí văn bản thân trong nhiều cột

PageSetup.TextColumns trả về một TextColumnCollection cho phần. Gọi SetCount() với số cột mà văn bản thân nên chảy vào, sau đó điều chỉnh EvenlySpaced, Spacing, LineBetween và Width để kiểm soát cách bố trí các cột. Khi bộ sưu tập chứa nhiều hơn một cột, các thể hiện TextColumn riêng lẻ sẽ hiển thị Width và SpaceAfter của chúng.

Bước 8: Xóa hoặc Chỉnh sửa Hàng loạt Nội dung Phần

Section.AppendContent() và PrependContent() sao chép nội dung thân của một phần khác vào phần này; ClearContent() xóa toàn bộ nội dung thân của một phần một cách hàng loạt. ClearHeadersFooters() và DeleteHeaderFooterShapes() xóa nội dung tiêu đề và chân trang trên toàn bộ phần mà không xóa phần đó.