Cách làm việc với tài liệu trong .NET

Bước 1: Lấy Thư viện

Sao chép kho lưu trữ và biên dịch Aspose.Words.sln ở cấu hình Release, sau đó thêm tham chiếu dự án tới Aspose.Words.csproj từ dự án .NET của bạn. Các lệnh sao chép và biên dịch đầy đủ có trong Hướng dẫn cài đặt. Sau khi đã tham chiếu, thêm using Aspose.Words; ở đầu bất kỳ tệp nào làm việc với tài liệu.

Bước 2: Tạo hoặc tải tài liệu

Gọi new Document() để tạo tài liệu trống, hoặc truyền đường dẫn tệp hoặc Stream vào hàm khởi tạo Document(fileName) / Document(stream) để mở một tài liệu hiện có. Một overload chấp nhận đối số LoadOptions cho phép bạn cung cấp mật khẩu cho tệp được mã hóa. Trước khi tải một tệp mà định dạng của nó bạn chưa tin cậy, hãy gọi FileFormatUtil.DetectFileFormat(fileName) — nó trả về một FileFormatInfo báo cáo LoadFormat được phát hiện và liệu tệp IsEncrypted, HasDigitalSignature hoặc HasMacros, để bạn có thể từ chối đầu vào không mong muốn trước khi Document cố gắng phân tích nó.

Bước 3: Tạo nội dung với DocumentBuilder

DocumentBuilder bao bọc một Document với một con trỏ mà bạn di chuyển qua cây khi chèn nội dung. Write(text) và Writeln(text) chèn văn bản tại con trỏ, và InsertParagraph() bắt đầu một đoạn mới. Định dạng được đặt trên các thuộc tính Font, ParagraphFormat, ListFormat, và PageSetup của builder sẽ áp dụng cho bất kỳ nội dung nào bạn viết tiếp theo. Di chuyển lại con trỏ bằng MoveToDocumentStart(), MoveToDocumentEnd(), MoveToSection(sectionIndex), MoveToBookmark(bookmarkName), hoặc MoveToParagraph(paragraphIndex, characterIndex), và đọc CurrentNode / CurrentParagraph / CurrentSection để xác nhận vị trí của builder.

Bước 4: Kiểm tra cấu trúc Phần và Thân

Một Document hiển thị một SectionCollection thông qua Document.Sections (cộng với FirstSection / LastSection). Mỗi Section có đúng một Body, nội dung chính của nó có thể truy cập qua Body.Paragraphs (một ParagraphCollection) và Body.Tables. Để đọc hoặc tìm kiếm văn bản mà không phải duyệt các nút thủ công, sử dụng Range có sẵn trên Document, Section, Paragraph, và các nút khác — Range.Text trả về văn bản thuần, và Range.Replace(pattern, replacement) thực hiện tìm-thay trong phạm vi chỉ của đoạn đó.

Bước 5: Kết hợp Hai Tài liệu

Để sao chép toàn bộ một tài liệu, gọi Document.Clone(). Để đưa nội dung cụ thể từ một thể hiện Document vào một thể hiện khác, gọi ImportNode(srcNode, isImportChildren) trên tài liệu đích, hoặc gọi Document.AppendDocument(srcDoc, importFormatMode) để nối mỗi phần của tài liệu nguồn vào cuối tài liệu hiện tại. DocumentBuilder.InsertDocument(srcDoc, importFormatMode) thực hiện cùng thao tác nhưng chèn tại con trỏ của builder thay vì ở cuối. Trong cả ba trường hợp, hãy chọn giá trị ImportFormatMode — KeepSourceFormatting, UseDestinationStyles, hoặc KeepDifferentStyles — một cách có chủ ý, vì nó quyết định phong cách của tài liệu nào sẽ thắng khi hai tài liệu xung đột.

Bước 6: Áp dụng Hạn chế Chỉnh sửa

Gọi Document.Protect(type, password) với một giá trị ProtectionType — ReadOnly, AllowOnlyComments, AllowOnlyRevisions, hoặc AllowOnlyFormFields — để hạn chế các chỉnh sửa mà Word chấp nhận cho tài liệu. Unprotect() (có hoặc không có mật khẩu tương ứng) sẽ gỡ bỏ hạn chế. Điều này chỉ ảnh hưởng đến việc chỉnh sửa trong Word; nó không mã hoá tệp đã lưu. Để yêu cầu mật khẩu chỉ để mở tệp, đặt OoxmlSaveOptions.Password khi bạn lưu.