Cách xuất và lưu tài liệu Word trong .NET

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

Sao chép kho và biên dịch Aspose.Words.sln trong 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, như mô tả trong Hướng dẫn cài đặt. Thêm using Aspose.Words; ở đầu bất kỳ tệp nào lưu tài liệu.

Bước 2: Lưu với định dạng suy ra hoặc rõ ràng

Document.Save(fileName) suy ra định dạng đích từ phần mở rộng của tệp. Save(fileName, saveFormat) làm cho định dạng trở nên rõ ràng bất kể phần mở rộng bằng cách nhận một giá trị enum SaveFormat, và Save(fileName, saveOptions) (hoặc các overload Stream tương ứng) nhận một lớp con SaveOptions để kiểm soát riêng cho định dạng. SaveOptions.CreateSaveOptions(saveFormat) là một nhà máy tĩnh trả về lớp con tùy chọn phù hợp với các giá trị mặc định đã được thiết lập cho một SaveFormat nhất định. Phiên bản này lưu hoàn toàn cả vào và từ DOCX, DOCM, DOTX, DOTM và Flat OPC (cùng với các biến thể hỗ trợ macro và mẫu), cũng như Markdown và văn bản thuần.

Bước 3: Cấu hình tùy chọn xuất OOXML

OoxmlSaveOptions cấu hình việc lưu vào bất kỳ biến thể Open XML nào. Thuộc tính SaveFormat của nó chọn DOCX, DOCM, DOTX, DOTM, hoặc Flat OPC một cách cụ thể; Password đặt mật khẩu mở cho tệp đã lưu, độc lập với hạn chế chỉnh sửa của Document.Protect; Compliance chọn mức độ nghiêm ngặt của OOXML; và CompressionLevel / Zip64Mode kiểm soát việc đóng gói ZIP nền tảng. Tạo một cái bằng new OoxmlSaveOptions(saveFormat) hoặc thông qua SaveOptions.CreateSaveOptions(saveFormat).

Bước 4: Xuất sang Markdown

MarkdownSaveOptions kiểm soát việc xuất Markdown: ListExportMode và LinkExportMode quyết định cách danh sách và siêu liên kết được hiển thị, ImagesFolder / ImagesFolderAlias kiểm soát nơi các hình ảnh đã trích xuất được lưu và cách chúng được tham chiếu, ExportImagesAsBase64 nhúng chúng vào nội dung thay vì ghi thành các tệp riêng, và TableContentAlignment ảnh hưởng đến đánh dấu bảng được tạo. Gửi một thể hiện MarkdownSaveOptions tới Document.Save(fileName, saveOptions) với tên tệp .md, hoặc đặt SaveFormat của nó một cách rõ ràng.

Bước 5: Xuất sang Văn bản Thuần

TxtSaveOptions (thông qua cơ sở chung TxtSaveOptionsBase, cũng được MarkdownSaveOptions sử dụng) kiểm soát việc xuất văn bản thuần: Encoding đặt mã ký tự, ParagraphBreak đặt chuỗi kết thúc dòng, MaxCharactersPerLine gói các dòng dài, SimplifyListLabels chuẩn hoá các dấu đầu mục và số của danh sách thành ký tự thuần, và PreserveTableLayout giữ cho các cột bảng được căn chỉnh bằng cách sử dụng khoảng trắng.

Bước 6: Phát hiện định dạng trước khi chuyển đổi

Trước khi chuyển đổi một tệp có định dạng không xác định, FileFormatUtil.DetectFileFormat(fileName) trả về một FileFormatInfo với LoadFormat đã phát hiện. Kết hợp nó với FileFormatUtil.LoadFormatToSaveFormat(loadFormat) để kiểm tra xem định dạng đó có thể quay lại qua các định dạng được hỗ trợ của phiên bản này trước khi gọi Document.Save. Một số thành viên enum SaveFormat tồn tại để hoàn thiện API nhưng tên các định dạng này đã được rút gọn, phiên bản mã nguồn mở không triển khai bộ đọc hoặc ghi hoạt động cho chúng; hãy dùng họ DOCX/DOCM/DOTX/DOTM/Flat OPC cùng với Markdown và văn bản thuần để có đầu ra đáng tin cậy.