Class HtmlSaveOptions

Tên không gian: Aspose.Words.Saving Tổng hợp: Aspose.Words.dll (25.4.0)

Có thể được sử dụng để chỉ định các tùy chọn bổ sung khi lưu một tài liệu trongTải về Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.EpubĐịnh dạng Aspose.Words.SaveFormat.Azw3 hoặc Aspose.Words.SaveFormat.Mobi.

Để tìm hiểu thêm, hãy ghé thăm Specify Save Options tài liệu bài viết.

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

Thành viên thừa kế

SaveOptions.CreateSaveOptions(SaveFormat) , SaveOptions.CreateSaveOptions(string) , SaveOptions.SaveFormat , SaveOptions.ExportGeneratorName , SaveOptions.TempFolder , SaveOptions.PrettyFormat , SaveOptions.UseAntiAliasing , SaveOptions.UseHighQualityRendering , SaveOptions.DmlRenderingMode , SaveOptions.DmlEffectsRenderingMode , SaveOptions.ImlRenderingMode , SaveOptions.DefaultTemplate , SaveOptions.UpdateFields , SaveOptions.UpdateLastSavedTimeProperty , SaveOptions.UpdateLastPrintedProperty , SaveOptions.UpdateCreatedTimeProperty , SaveOptions.MemoryOptimization , SaveOptions.UpdateAmbiguousTextFont , SaveOptions.Dml3DEffectsRenderingMode , SaveOptions.ProgressCallback , SaveOptions.AllowEmbeddingPostScriptFonts , SaveOptions.CustomTimeZoneInfo , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

HtmlSaveOptions()

Khởi động một ví dụ mới của lớp này có thể được sử dụng để lưu một tài liệutrong định dạng Aspose.Words.SaveFormat.Html.

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

Khởi động một ví dụ mới của lớp này có thể được sử dụng để lưu một tài liệutrong Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Định dạng Aspose.Words.SaveFormat.Azw3 hoặc Aspose.Words.SaveFormat.Mobi.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

Có thể là Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Tải về Aspose.Words.SaveFormat.Azw3 hoặc Aspose.Words.SaveFormat.Mobi

Properties

AllowNegativeIndent

Nó xác định liệu các phần trái và phải tiêu cực của các đoạn được bình thường hóa khi lưu vào HTML, MHTML hoặc EPUB.

public bool AllowNegativeIndent { get; set; }

Giá trị bất động sản

bool

Remarks

Khi indent tiêu cực không được phép, nó được xuất khẩu như là margin zero cho HTML. Khi indent tiêu cực được phép, một đoạn có thể xuất hiện một phần bên ngoài cửa sổ trình duyệt.

CssClassNamePrefix

Nó chỉ định một tiền tệ được thêm vào tất cả các tên lớp CSS.Giá trị mặc định là một dòng trống và các tên lớp CSS được tạo không có tiền đề phổ biến.

public string CssClassNamePrefix { get; set; }

Giá trị bất động sản

string

Remarks

Nếu giá trị này không trống rỗng, tất cả các lớp CSS được tạo bởi Aspose.Words sẽ bắt đầu với cài đặt cụ thể. điều này có thể hữu ích, ví dụ, nếu bạn thêm CSS tùy chỉnh vào các tài liệu được tạo và muốn ngăn chặn xung đột tên lớp.

Nếu giá trị không hoặc trống, nó phải là một ID CSS hợp lệ.

Exceptions

ArgumentException

Giá trị không trống và không phải là ID CSS hợp lệ.

CssSavingCallback

Cho phép kiểm soát làm thế nào các phong cách CSS được lưu khi một tài liệu được lưu vào HTML, MHTML hoặc EPUB.

public ICssSavingCallback CssSavingCallback { get; set; }

Giá trị bất động sản

ICssSavingCallback

CssStyleSheetFileName

Chọn con đường và tên của tệp Cascading Style Sheet (CSS) được viết khi một tài liệuđược xuất khẩu sang HTML.Default là một dòng trống.

public string CssStyleSheetFileName { get; set; }

Giá trị bất động sản

string

Remarks

Tài sản này chỉ có hiệu lực khi bạn lưu một tài liệu trong định dạng HTML và bảng kiểu CSS bên ngoài được yêu cầu sử dụng Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType.

Nếu tài sản này trống rỗng, tệp CSS sẽ được lưu vào cùng một thư mục và cùng tên với tài liệu HTML nhưng với phần mở rộng “.css”.

Nếu chỉ có con đường nhưng không có tên tệp được chỉ định trong tài sản này, tệp CSS sẽ được lưu vào thư mục được chỉ định và sẽ có cùng tên như tài liệu HTML nhưng với phần mở rộng “.css”.

Nếu thư mục được xác định bởi tài sản này không tồn tại, nó sẽ được tạo tự động trước khi tệp CSS được lưu.

Một cách khác để xác định một thư mục nơi tệp CSS bên ngoài được lưu là sử dụng Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder.

Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder Aspose.Words.Saving.HtmlSaveOptions.ResourceFolderAlias Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType

CssStyleSheetType

Nó xác định làm thế nào các phong cách CSS (Cascading Style Sheet) được xuất vào HTML, MHTML hoặc EPUB.Giá trị mặc định là Aspose.Words.Saving.CssStyleSheetType.Inline cho HTML/MHTML vàAspose.Words.Saving.CssStyleSheetType.External cho EPUB.

public CssStyleSheetType CssStyleSheetType { get; set; }

Giá trị bất động sản

CssStyleSheetType

Remarks

Tiết kiệm CSS style sheet vào một tệp bên ngoài chỉ được hỗ trợ khi lưu vào HTML. Khi bạn đang xuất sang một trong các định dạng container (EPUB hoặc MHTML) và xác định Aspose.Words.Saving.CssStyleSheetType.External, tập tin CSS sẽ được kết hợp vào gói output.

Xem thêm

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

Cho phép kiểm soát cách các bộ phận tài liệu được lưu khi một tài liệu được lưu vào HTML hoặc EPUB.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

Giá trị bất động sản

IDocumentPartSavingCallback

DocumentSplitCriteria

Nói cách nào tài liệu nên được chia khi lưu vào Aspose.Words.SaveFormat.Html,Các định dạng Aspose.Words.SaveFormat.Epub hoặc Aspose.Words.SaveFormat.Azw3Theo mặc định là Aspose.Words.Saving.DocumentSplitCriteria.No cho HTML vàAspose.Words.Saving.DocumentSplitCriteria.HeadingĐiều cho EPUB và AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

Giá trị bất động sản

DocumentSplitCriteria

Remarks

Thông thường bạn sẽ muốn một tài liệu được lưu vào HTML như một tệp duy nhất. Nhưng trong một số trường hợp, nó là thích hợp để chia output thành nhiều trang HTML nhỏ hơn. Khi lưu sang định dạng HTML, các trang này sẽ là kết quả cho các tập tin cá nhân hoặc dòng.

Một tài liệu không thể được chia khi lưu trong định dạng MHTML.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitHeadingLevel Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

DocumentSplitHeadingLevel

Chọn mức tiêu đề tối đa để chia tài liệu.Giá mặc định là ‘2’.

public int DocumentSplitHeadingLevel { get; set; }

Giá trị bất động sản

int

Remarks

Khi Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria bao gồm Wl26.Nhận xét.Thuyết điểmĐiểm và tài sản này được thiết lập cho một giá trị từ 1 đến 9, tài liệu sẽ được chia thành các đoạn được định dạng bằng cách sử dụng , , vv. phong cách lên đến mức tiêu đề cụ thể.

Theo mặc định, chỉ có và các đoạn làm cho tài liệu được chia rẽ. đặt tài sản này ở mức zero sẽ gây ra rằng tài khoản không được phân chia ở những đoạn đầu.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

Encoding

Tùy chọn mã hóa để sử dụng khi xuất sang HTML, MHTML hoặc EPUB.Giá mặc định là ‘UTF8Encoding(fake)’ (UTF-8 không có BOM).

public Encoding Encoding { get; set; }

Giá trị bất động sản

Encoding

ExportCidUrlsForMhtmlResources

Nó xác định xem bạn có nên sử dụng CID (Content-ID) URL cho các tài nguyên tham khảo (Ảnh, phông chữ, CSS) được bao gồm trong các tài liệu MHTML.

public bool ExportCidUrlsForMhtmlResources { get; set; }

Giá trị bất động sản

bool

Remarks

Tùy chọn này chỉ ảnh hưởng đến các tài liệu được lưu vào MHTML.

Theo mặc định, tài nguyên trong các tài liệu MHTML được đề cập bằng tên tệp (ví dụ, “image.png”), mà được phù hợp với tiêu đề “Content-Location” của các phần MIME.

Tùy chọn này cho phép một phương pháp thay thế, nơi tham chiếu đến các tập tin tài nguyên được viết như CID (Content-ID) URL (ví dụ, “cid:image.png”) và được phù hợp với tiêu đề “Content-ID”.

Về lý thuyết, không có sự khác biệt giữa hai phương pháp tham khảo và cả hai phương pháp này nên hoạt động tốt trong bất kỳ trình duyệt hoặc đại lý thư. Tuy nhiên, trong thực tế, một số đại lý không thể thu thập tài nguyên bằng tên tệp. Nếu trình duyệt hoặc đại lý thư của bạn từ chối tải các tài nguyên bao gồm trong tài liệu MTHML (không hiển thị hình ảnh hoặc không tải các phong cách CSS), hãy thử xuất tài liệu với URL CID.

ExportDocumentProperties

Nó xác định xem để xuất các thuộc tính tài liệu tích hợp và tùy chỉnh cho HTML, MHTML hoặc EPUB.Giá mặc định là ’lầm’.

public bool ExportDocumentProperties { get; set; }

Giá trị bất động sản

bool

ExportDropDownFormFieldAsText

Kiểm soát làm thế nào các trường biểu mẫu drop-down được lưu vào HTML hoặc MHTML.Giá mặc định là ’lầm'.

public bool ExportDropDownFormFieldAsText { get; set; }

Giá trị bất động sản

bool

Remarks

Khi cài đặt , xuất các trường biểu mẫu drop-down như văn bản bình thường. khi , xuất các trường biểu mẫu drop-down như yếu tố SELECT trong HTML.

Khi xuất sang EPUB, các trường biểu mẫu text drop-down luôn được lưu như văn bản do yêu cầu của định dạng này.

ExportFontResources

Nó xác định xem tài nguyên phông chữ có nên được xuất vào HTML, MHTML hoặc EPUB hay không.Default là ‘một giả’.

public bool ExportFontResources { get; set; }

Giá trị bất động sản

bool

Remarks

<p>Exporting font resources allows for consistent document rendering independent of the fonts available
         in a given user's environment.</p>

Nếu Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources được thiết lập , tài liệu HTML chính sẽ đề cập đến mỗi phông chữ thông qua CSS 3 theo quy định và các font sẽ được phát hành như các tệp riêng biệt.

Nếu Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 được thiết lập , các phông chữ sẽ không được lưu trữ cho các tệp riêng biệt.

Khi xuất khẩu tài nguyên văn bản, các vấn đề cấp phép chữ phải được xem xét. Các tác giả muốn sử dụng các chữ cụ thể thông qua một cơ chế chữ có thể tải về phải luôn luôn cẩn thận xác minh rằng việc dùng dự định của họ nằm trong phạm vi của giấy phép. Nhiều chữ thương mại hiện tại không cho phép tải xuống web của chữ của mình trong bất kỳ hình thức nào. các thỏa thuận Giấy phép bao gồm một số chữ cái đặc biệt lưu ý rằng sự áp dụng qua các quy tắc trong các bảng kiểu CSS không được chấp thuận.

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

Nó xác định liệu các tài nguyên phông chữ nên được nhúng vào HTML trong Base64 mã hóa.Default là ’lầm lẫn'.

public bool ExportFontsAsBase64 { get; set; }

Giá trị bất động sản

bool

Remarks

Theo mặc định, các phông chữ được viết thành tệp riêng biệt. nếu tùy chọn này được thiết lập , các phông chữ sẽ được nhúng vào CSS của tài liệu trong mã hóa Base64.

ExportHeadersFootersMode

Nó xác định làm thế nào đầu và chân là kết quả cho HTML, MHTML hoặc EPUB.Giá trị mặc định là Aspose.Words.Saving.ExportHeadersFootersMode.PerSection cho HTML/MHTMLvà Aspose.Words.Saving.ExportHeadersFootersMode.None cho EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

Giá trị bất động sản

ExportHeadersFootersMode

Remarks

Thật khó để có ý nghĩa đầu xuất và chân đến HTML bởi vì HTML không được trang.

Khi tài sản này là Aspose.Words.Saving.ExportHeadersFootersMode.PerSection, Aspose.Words chỉ xuất khẩu đầu và chân chính ở đầu và cuối mỗi phần.

Khi nó là Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectionFooter chỉ đầu tiên đầu và cuối cùng đầu (bao gồm liên kết với trước) được xuất khẩu.

Bạn có thể vô hiệu hóa xuất khẩu đầu và chân hoàn toàn bằng cách đặt tài sản này vào Aspose.Words.Saving.ExportHeadersFootersMode.None.

ExportImagesAsBase64

Nó xác định xem hình ảnh được lưu trữ trong định dạng Base64 cho kết quả HTML, MHTML hoặc EPUB.Default là ’lầm'.

public bool ExportImagesAsBase64 { get; set; }

Giá trị bất động sản

bool

Remarks

Khi tài sản này được thiết lập cho hình ảnh, dữ liệu được xuất trực tiếp vào các yếu tố và các tệp riêng biệt không được tạo ra.

ExportLanguageInformation

Nó xác định liệu thông tin ngôn ngữ được xuất vào HTML, MHTML hoặc EPUB.Default là ’lầm lẫn'.

public bool ExportLanguageInformation { get; set; }

Giá trị bất động sản

bool

Remarks

Khi thuộc tính này được thiết lập cho Aspose.Words xuất xứ HTML thuộc tính trên các yếu tố tài liệu xác định ngôn ngữ.

ExportListLabels

Kiểm tra làm thế nào các nhãn danh sách là kết quả để HTML, MHTML hoặc EPUB.Giá trị mặc định là Aspose.Words.Saving.ExportListLabels.Auto.

public ExportListLabels ExportListLabels { get; set; }

Giá trị bất động sản

ExportListLabels

ExportOriginalUrlForLinkedImages

Nó xác định xem URL gốc có nên được sử dụng như URL của các hình ảnh liên kết.Giá mặc định là ’lầm'.

public bool ExportOriginalUrlForLinkedImages { get; set; }

Giá trị bất động sản

bool

Remarks

Nếu giá trị được đặt vào Aspose.Words.Drawing.ImageData.SourceFullName giá trị được sử dụng như URL của hình ảnh liên kết và hình ảnh liên kết không được tải vào thư mục tài liệu hoặc Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder.

Nếu giá trị được thiết lập cho các hình ảnh liên kết được tải vào thư mục của tài liệu hoặc Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder và URL của mỗi bức ảnh được xây dựng tùy thuộc vào mảng của Tài liệu, Wl26.Năm.Thông tin.Phản phẩm.Quả năng.Với các thuộc tính của văn bản.

ExportPageMargins

Nó xác định xem margin trang có được xuất vào HTML, MHTML hoặc EPUB hay không.Default là giả.

public bool ExportPageMargins { get; set; }

Giá trị bất động sản

bool

Remarks

Aspose.Words không hiển thị phạm vi của margin trang theo mặc định.Nếu bất kỳ yếu tố nào được hoàn toàn hoặc một phần nhấp vào cạnh tài liệu, khu vực hiển thị có thể được mở rộng vớitùy chọn này.

ExportPageSetup

Nó chỉ định xem thiết lập trang có được xuất vào HTML, MHTML hoặc EPUB hay không.Default là ’lỗi'.

public bool ExportPageSetup { get; set; }

Giá trị bất động sản

bool

Remarks

Mỗi Aspose.Words.Section trong Aspose.Words tài liệu mô hình cung cấp thông tin cài đặt trang thông qua Aspose.Words.PageSetup lớp. Khi bạn xuất một tài liệu sang định dạng HTML bạn có thể cần phải giữ thông tin này cho việc sử dụng tiếp theo. Đặc biệt, cài đặt trang có thể quan trọng để chuyển sang phương tiện truyền thông (bài in) hoặc chuyển đổi sau đó sang định dạng tệp Microsoft Word bản địa (DOCX, DOC, RTF, WML).

Trong hầu hết các trường hợp, HTML được thiết kế để xem trong các trình duyệt nơi trang web không được thực hiện.

ExportRelativeFontSize

Nó xác định xem kích thước phông chữ có phải là kết quả trong các đơn vị tương đối khi lưu vào HTML, MHTML hoặc EPUB.Default là ’lầm lẫn'.

public bool ExportRelativeFontSize { get; set; }

Giá trị bất động sản

bool

Remarks

Trong nhiều tài liệu hiện có (HTML, IDPF EPUB) kích thước phông chữ được chỉ định trong các đơn vị tương đối. Điều này cho phép các ứng dụng để điều chỉnh kích cỡ văn bản khi xem / xử lý các Tài liệu. Ví dụ, Microsoft Internet Explorer có “View->Text Size” phụ menu, Adobe Digital Editions có hai nút: Tăng / Giảm Text Size. Nếu bạn mong đợi chức năng này để làm việc sau đó thiết lập Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize thuộc tính để .

WL51_ Mô hình tài liệu Words chứa và chỉ hoạt động với các đơn vị kích thước phông chữ tuyệt đối. Đơn vị tương đối cần logic bổ sung để được tính toán lại từ một số kích cỡ ban đầu (thường) . Tích thước font của phong cách văn bản được lấy làm tiêu chuẩn. Ví dụ, nếu có 12pt font và một vài text là 18pt thì nó sẽ là kết quả về HTML.

Khi tùy chọn này được bật, các yếu tố tài liệu khác ngoài văn bản sẽ vẫn có kích cỡ tuyệt đối. Ngoài ra, một số thuộc tính liên quan đến văn Bản có thể được thể hiện hoàn toàn. Đặc biệt, đường lối được chỉ định với quy tắc “tính chính xác” có khả năng tạo ra kết quả không mong muốn khi quy mô văn viết. Vì vậy, tài khoản nguồn nên được thiết kế và kiểm tra đúng cách khi xuất với Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize thiết lập cho .

ExportRoundtripInformation

Nó xác định xem để viết thông tin vòng tròn khi lưu vào HTML, MHTML hoặc EPUB.Giá mặc định là ’thật’ cho HTML và ’thật’ cho MHTML và EPUB.

public bool ExportRoundtripInformation { get; set; }

Giá trị bất động sản

bool

Remarks

Tiết kiệm thông tin vòng tròn cho phép khôi phục các thuộc tính tài liệu như tab stops, bình luận, headers và footers trong khi các tài liệu HTML tải lại vào một Aspose.Words.Document đối tượng.

Khi , thông tin vòng tròn được xuất khẩu như -aw-* CSS thuộc tính của các yếu tố HTML tương ứng.

Khi , không gây ra thông tin vòng tròn để được xuất vào các tập tin được sản xuất.

ExportShapesAsSvg

Kiểm tra xem các nút Aspose.Words.Drawing.Shape được chuyển đổi thành hình ảnh SVG khi lưu vào HTML, MHTML, EPUB hoặc AZW3.

public bool ExportShapesAsSvg { get; set; }

Giá trị bất động sản

bool

Remarks

Nếu tùy chọn này được thiết lập cho , Aspose.Words.Drawing.Shape nodes được xuất khẩu nhưcác thành phần.

ExportTextInputFormFieldAsText

Kiểm tra làm thế nào các trường biểu mẫu nhập văn bản được lưu vào HTML hoặc MHTML.Giá mặc định là ’lầm'.

publicboolExportTextInputFormFieldAsText{get;set;}