Cách làm việc với Cài đặt Tài liệu trong .NET
Hướng dẫn này chỉ cách làm việc với các cài đặt tài liệu ở mức ứng dụng trong Aspose.Words FOSS cho .NET: các công tắc tương thích cũ, tùy chọn gạch nối, cấu hình mail-merge đã lưu, các tùy chọn hiển thị và bảo vệ ghi. Aspose.Words FOSS cho .NET có sẵn qua NuGet hoặc bằng cách biên dịch từ nguồn.
Hướng dẫn từng bước
Bước 1: Lấy Thư viện
Clone 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; and using Aspose.Words.Settings; ở đầu bất kỳ tệp nào đọc hoặc ghi cài đặt tài liệu.
Bước 2: Đặt các Tùy chọn Tương thích Cũ
Document.CompatibilityOptions (một thể hiện CompatibilityOptions) chứa hàng chục công tắc boolean tái tạo các hành vi bố cục và khoảng cách đặc trưng của các phiên bản Word cũ — ví dụ GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, và SpacingInWholePoints. Đặt các thuộc tính riêng lẻ mà bạn cần trực tiếp; OptimizeFor(MsWordVersion) có trong lớp nhưng ném NotImplementedException trong bản dựng này, vì vậy không có phím tắt nào áp dụng toàn bộ hồ sơ phiên bản cùng một lúc.
Bước 3: Cấu hình Tùy chọn Gạch Nối
Document.HyphenationOptions (một thể hiện HyphenationOptions) lưu các tùy chọn gạch nối của Word cho tài liệu: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, và HyphenationZone. Các thuộc tính này truyền lại yêu cầu trong tệp đã lưu; vì phiên bản này không có công cụ bố cục trang, các điểm ngắt gạch nối được tính toán bởi Word khi nó mở và phân trang tệp, không phải bởi Aspose.Words FOSS.
Bước 4: Đọc và Ghi Cấu hình Gộp Thư
Document.MailMergeSettings (một thể hiện MailMergeSettings) lưu cấu hình gộp thư được ghi trong tài liệu — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord, và ViewMergedData — cộng với Clear() và Clone(). Đối với nguồn dữ liệu bên ngoài được kết nối qua cơ chế Office Data Source Object của Word, MailMergeSettings.Odso cung cấp một thể hiện Odso (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), mà các bộ sưu tập FieldMapDatas và RecipientDatas mô tả việc ánh xạ trường và danh sách người nhận. Việc đọc và ghi cấu hình đã lưu này có sẵn trong phiên bản mã nguồn mở này; việc thực hiện việc gộp thực tế trên một nguồn dữ liệu trực tiếp là một vấn đề riêng ngoài phạm vi của trang này.
Bước 5: Cấu hình Cài đặt Hiển thị Tài liệu
Document.ViewOptions (một thể hiện ViewOptions) kiểm soát cách Word hiển thị tệp sau khi mở: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries, và FormsDesign. Các thuộc tính này là các tùy chọn được lưu chỉ ảnh hưởng đến việc hiển thị tài liệu của Word — chúng không liên quan đến cách Aspose.Words FOSS tự xử lý nó.
Bước 6: Áp dụng Bảo vệ Ghi
Document.WriteProtection (một thể hiện WriteProtection) cung cấp IsWriteProtected và ReadOnlyRecommended, với SetPassword() để thiết lập mật khẩu bảo vệ và ValidatePassword() để kiểm tra mật khẩu đề xuất so với nó. Gọi SetPassword() trước khi thiết lập IsWriteProtected = true, và sử dụng ValidatePassword() thay vì tự lưu trữ hoặc so sánh chuỗi mật khẩu thô.
Các vấn đề thường gặp và cách khắc phục
CompatibilityOptions.OptimizeFor() throws NotImplementedException. Phương thức này chưa được triển khai trong bản dựng này. Đặt các CompatibilityOptions thuộc tính boolean bạn cần trực tiếp thay vào đó.
Changing ViewOptions.ZoomPercent không có ảnh hưởng nhìn thấy được đối với đầu ra được tạo. ViewOptions là một tùy chọn hiển thị được lưu và đọc bởi Word, không phải thứ gì đó Aspose.Words FOSS tự áp dụng trong quá trình xử lý. Không cần sửa — đây là điều dự kiến.
WriteProtection.ValidatePassword() trả về một cách bất ngờ false. SetPassword() không bao giờ được gọi, hoặc một mật khẩu khác đã được đặt. Gọi SetPassword() đầu tiên để thiết lập mật khẩu bảo vệ trước khi xác thực.
Cấu hình mail-merge được lưu nhưng quá trình hợp nhất không chạy. MailMergeSettings and Odso chỉ lưu cấu hình hợp nhất; phiên bản mã nguồn mở này không thực thi việc hợp nhất. Đọc cấu hình đã lưu và tự triển khai logic điền dữ liệu trường dựa trên nó.
Câu hỏi thường gặp
Liệu CompatibilityOptions.OptimizeFor() có hoạt động không?
Không — nó ném NotImplementedException trong bản dựng này. Đặt các thuộc tính CompatibilityOptions riêng lẻ mà bạn cần trực tiếp.
Làm thế nào để tôi đặt mật khẩu bảo vệ tài liệu khỏi việc chỉnh sửa?
Gọi WriteProtection.SetPassword() trên Document.WriteProtection, sau đó đặt IsWriteProtected để bật bảo vệ.
Liệu HyphenationOptions và ViewOptions có thay đổi cách tài liệu hiển thị khi Aspose.Words FOSS xử lý nó không?
Không. Cả hai đều là các tùy chỉnh được lưu mà Word tự áp dụng khi mở và hiển thị tệp; phiên bản này không có công cụ bố cục trang để xử lý chúng trực tiếp.
Tôi có thể tìm cấu hình nguồn dữ liệu mail-merge cho nguồn dữ liệu bên ngoài ở đâu?
MailMergeSettings.Odso — các bộ sưu tập FieldMapDatas và RecipientDatas của nó mô tả ánh xạ cột và trạng thái bao gồm người nhận.
Sự khác nhau giữa Document.CompatibilityOptions và Document.ViewOptions là gì?
CompatibilityOptions công tắc tái hiện bố cục và các lỗi khoảng cách của Word cũ; ViewOptions kiểm soát cách giao diện Word hiển thị tệp (thu phóng, dấu định dạng). Cả hai không được tính toán bởi Aspose.Words FOSS tự nó.