Class HtmlSaveOptions

Nazwa przestrzeń: Aspose.Words.Saving Zgromadzenie: Aspose.Words.dll (25.4.0)

Może być używany do określenia dodatkowych opcji podczas przechowywania dokumentu wWystępuje w programie Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Format Aspose.Words.SaveFormat.Azw3 lub Aspose.Words.SaveFormat.Mobi.

Aby dowiedzieć się więcej, odwiedź Specify Save Options Artykuł dokumentacyjny .

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

Dziedziczeni członkowie

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()

Inicjalizuje nową instancję tej klasy, która może być używana do zapisania dokumentuw formacie Aspose.Words.SaveFormat.Html.

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

Inicjalizuje nową instancję tej klasy, która może być używana do zapisania dokumentuw Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Format Aspose.Words.SaveFormat.Azw3 lub Aspose.Words.SaveFormat.Mobi.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

Może to być Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Aspose.Words.SaveFormat.Azw3 lub Aspose.Words.SaveFormat.Mobi.

Properties

AllowNegativeIndent

Określa, czy negatywne lewicowe i prawicowe wskaźniki paragrafów są normalizowanew czasie przechowywania do HTML, MHTML lub EPUB.

public bool AllowNegativeIndent { get; set; }

Wartość nieruchomości

bool

Remarks

Kiedy negatywny indent nie jest dozwolony, jest on eksportowany jako zero margin do HTML. Kiedy negatywny indent jest dozwolony, paragraf może pojawić się częściowo poza oknem przeglądarki.

CssClassNamePrefix

Określa prefix, który jest dodany do wszystkich nazw klas CSS.Wartość domyślna jest pustym paskiem, a generowane nazwy klasy CSS nie mają wspólnego prefix.

public string CssClassNamePrefix { get; set; }

Wartość nieruchomości

string

Remarks

Jeśli ta wartość nie jest pusta, wszystkie klasy CSS generowane przez Aspose.Words rozpoczną się od określonego uprzedzenia.To może być przydatne, na przykład, jeśli dodasz dostosowane CSS do generowanych dokumentów i chcesz zapobiec konfliktom nazw klas.

Jeśli wartość nie jest lub jest pusta, musi to być ważny identyfikator CSS.

Exceptions

ArgumentException

Wartość nie jest pusta i nie jest ważnym identyfikatorem CSS.

CssSavingCallback

Pozwala kontrolować, jak styly CSS są zapisywane, gdy dokument jest zapisywany w HTML, MHTML lub EPUB.

public ICssSavingCallback CssSavingCallback { get; set; }

Wartość nieruchomości

ICssSavingCallback

CssStyleSheetFileName

Określa ścieżkę i nazwę pliku Cascading Style Sheet (CSS), który jest napisany, gdy dokumentJest eksportowany do HTML.Default to pusty pasek.

public string CssStyleSheetFileName { get; set; }

Wartość nieruchomości

string

Remarks

Ta właściwość działa tylko wtedy, gdy dokument jest zapisywany w formacie HTML, a zewnętrzny arkusz stylowy CSS jest wymagany za pomocą Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType.

Jeśli ta właściwość jest pusta, plik CSS zostanie zapisany w tym samym folderze i z tym samym nazwą jak dokument HTML, ale z rozszerzeniem “.css”.

Jeśli tylko ścieżka, ale żadna nazwa pliku nie jest określona w tej właściwości, plik CSS zostanie zapisany w określonej folderze i będzie miał to samo nazwisko jak dokument HTML, ale z rozszerzeniem “.css”.

Jeśli folder określony przez tę właściwość nie istnieje, zostanie on utworzony automatycznie przed zapisaniem pliku CSS.

Innym sposobem określenia folderu, w którym jest zapisywany zewnętrzny plik CSS jest użycie Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder.

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

CssStyleSheetType

Określa, w jaki sposób styl CSS (Cascading Style Sheet) jest eksportowany do HTML, MHTML lub EPUB.Podstawową wartością jest Aspose.Words.Saving.CssStyleSheetType.Inline dla HTML/MHTML iAspose.Words.Saving.CssStyleSheetType.External dla EPUB.

public CssStyleSheetType CssStyleSheetType { get; set; }

Wartość nieruchomości

CssStyleSheetType

Remarks

Oszczędzanie arkusza stylu CSS do zewnętrznego pliku jest obsługiwane tylko podczas przechowywania do HTML. Kiedy eksportujesz do jednego z formatów kontenera (EPUB lub MHTML) i określając Aspose.Words.Saving.CssStyleSheetType.External, plik CSS zostanie włączony do pakietu wyjściowego.

Zobacz również

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

Pozwala kontrolować, jak części dokumentu są zapisywane, gdy dokument jest zapisywany w HTML lub EPUB.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

Wartość nieruchomości

IDocumentPartSavingCallback

DocumentSplitCriteria

Wyjaśnia, w jaki sposób dokument powinien być podzielony podczas przechowywania w Aspose.Words.SaveFormat.Html,Format Aspose.Words.SaveFormat.Epub lub Aspose.Words.SaveFormat.Azw3.Standardem jest Aspose.Words.Saving.DocumentSplitCriteria.Nie dla HTML iAspose.Words.Saving.DocumentSplitCriteria.HeadingParagraf dla EPUB i AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

Wartość nieruchomości

DocumentSplitCriteria

Remarks

Zwykle chcesz, aby dokument został zapisany do HTML jako pojedynczy plik. Ale w niektórych przypadkach lepiej jest podzielić wyjście na kilka mniejszych stron HTML. Kiedy przechowywać do formatu HTML te strony będą wyjściem do poszczególnych pliku lub strumieni.

Dokument nie może być podzielony podczas przechowywania w formacie MHTML.

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

DocumentSplitHeadingLevel

Określa maksymalny poziom nagłówków, w którym można podzielić dokument.Wyznaczona wartość wynosi ‘2’.

public int DocumentSplitHeadingLevel { get; set; }

Wartość nieruchomości

int

Remarks

Kiedy Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria obejmuje Wl26.Rozwiązanie dokumentów.HeadingParagraph i ta właściwość jest ustawiona na wartość od 1 do 9, dokument zostanie podzielony na ustępy formatowane za pomocą , , itp. stylów do określonego poziomu tytułu.

Wstępnie, tylko i paragrafy powodują, że dokument zostanie podzielony. Umieszczenie tej właściwości do zera spowoduje, iż dokument nie zostanie rozdzielony na tytułowych paragrafach w ogóle.

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

Encoding

Określa kodowanie do użycia podczas eksportu do HTML, MHTML lub EPUB.Wyznaczona wartość jest “nowy UTF8Encoding(false)” (UTF-8 bez BOM).

public Encoding Encoding { get; set; }

Wartość nieruchomości

Encoding

ExportCidUrlsForMhtmlResources

Określa, czy używać adresów URL CID (Content-ID) do zasobów odniesienia (obrazów, czcionek, CSS) zawartych w dokumentach MHTML.

public bool ExportCidUrlsForMhtmlResources { get; set; }

Wartość nieruchomości

bool

Remarks

Ta opcja dotyczy tylko dokumentów zapisywanych w MHTML.

Podstawowo zasoby w dokumentach MHTML są odwoływane przez nazwę pliku (na przykład “image.png”), które są dopasowane do nagłówków “Content-Location” części MIME.

Ta opcja umożliwia alternatywny sposób, w którym odniesienia do plików zasobów są napisane jako adresy URL CID (Content-ID) (na przykład “cid:image.png”) i są dopasowane przeciwko nagłówkom “Content-ID”.

W teorii nie powinno istnieć różnicy między dwoma metodami odniesienia, a każda z nich powinna działać dobrze w dowolnym przeglądarce lub agencie pocztowym. W praktyce jednak niektórzy agenci nie są w stanie złapać zasobów za pomocą nazwy pliku. Jeśli przeglądarka lub agencja pocztowa odmawia ładowania zasobów zawartych w dokumencie MTHML (nie wyświetla obrazu lub nie ładuje stylów CSS), spróbuj eksportować dokument z adresami URL CID.

ExportDocumentProperties

Określa, czy wyeksportować wbudowane i dostosowane właściwości dokumentu do HTML, MHTML lub EPUB.Wartość domyślna jest “fałszywa”.

public bool ExportDocumentProperties { get; set; }

Wartość nieruchomości

bool

ExportDropDownFormFieldAsText

Sprawdza, jak pola formularza drop-down są przechowywane do HTML lub MHTML.Wyznaczona wartość jest “fałszywa”.

public bool ExportDropDownFormFieldAsText { get; set; }

Wartość nieruchomości

bool

Remarks

Po ustawieniu na , wyeksportować pola formularza drop-down jako normalny tekst. Kiedy , wyeksportować pola formularza drop-down jako element SELECT w HTML.

Podczas eksportu do EPUB pola formularza tekstowego są zawsze zapisywane jako tekst ze względu na wymagania tego formatu.

ExportFontResources

Określa, czy zasoby czcionki powinny być eksportowane do HTML, MHTML lub EPUB.Default jest “fałszywy”.

public bool ExportFontResources { get; set; }

Wartość nieruchomości

bool

Remarks

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

Jeśli Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources jest ustawiony , główny dokument HTML będzie odwoływać się do każdego czcionki za pośrednictwem CSS 3 w porządku, a fonty zostaną wydane jako odrębne pliki.

Jeśli Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 jest ustawiony , czcionki nie zostaną zapisane do oddzielnych plików.

Podczas eksportu zasobów czcionek, należy wziąć pod uwagę kwestie licencjonowania font. Autorzy, którzy chcą używać określonych fontów za pośrednictwem pobieralnego mechanizmu font muszą zawsze uważnie sprawdzić, że ich zamierzone wykorzystanie znajduje się w zakresie licencji fontu. Wiele komercyjnych fonty obecnie nie pozwalają na przeglądanie stron internetowych ich liter w jakiejkolwiek formie. Porozumienia licencyjne, które obejmują niektóre litery w szczególności zauważa, iż korzystanie z reguł w arkuszach stylu CSS nie jest dozwolone.

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

Określa, czy zasoby czcionek powinny być włączone do HTML w kodowaniu Base64.Default jest “fałszywy”.

public bool ExportFontsAsBase64 { get; set; }

Wartość nieruchomości

bool

Remarks

Podstawowo, czcionki są napisane do oddzielnych plików. Jeśli ta opcja jest ustawiona , czcionki zostaną włączone do CSS dokumentu w kodowaniu Base64.

ExportHeadersFootersMode

Określa, w jaki sposób nagłówki i stopy są wynikiem HTML, MHTML lub EPUB.Podstawową wartością jest Aspose.Words.Saving.ExportHeadersFootersMode.PerSection dla HTML/MHTMLi Aspose.Words.Saving.ExportHeadersFootersMode.Nie dla EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

Wartość nieruchomości

ExportHeadersFootersMode

Remarks

Trudno znacząco wyprodukować nagłówki i stopy do HTML, ponieważ HTML nie jest strumieniowany.

Gdy ta nieruchomość jest Aspose.Words.Saving.ExportHeadersFootersMode.PerSection, Aspose.Words eksportuje tylko główne głowice i stopy na początku i końcu każdej sekcji.

Gdy jest to Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectFooter eksportowany jest tylko pierwszy główny i ostatni podstawowy footer (w tym powiązany z poprzednim).

Możesz unikać eksportu głowic i stopów w całości, ustawiając tę nieruchomość na stronie Aspose.Words.Saving.ExportHeadersFootersMode.None.

ExportImagesAsBase64

Określa, czy obrazy są przechowywane w formacie Base64 do wyjścia HTML, MHTML lub EPUB.Default jest “fałszywy”.

public bool ExportImagesAsBase64 { get; set; }

Wartość nieruchomości

bool

Remarks

Po ustawieniu tej właściwości na obrazy dane są eksportowane bezpośrednio do elementów, a oddzielne pliki nie są tworzone.

ExportLanguageInformation

Określa, czy informacje językowe są eksportowane do HTML, MHTML lub EPUB.Default jest “fałszywy”.

public bool ExportLanguageInformation { get; set; }

Wartość nieruchomości

bool

Remarks

Kiedy ta właściwość jest ustawiona na Aspose.Words wyjść atrybut HTML na elementy dokumentu, które określają język.

ExportListLabels

Sprawdź, jak etykiety listy są wyjściem do HTML, MHTML lub EPUB.Podstawową wartością jest Aspose.Words.Saving.ExportListLabels.Auto.

public ExportListLabels ExportListLabels { get; set; }

Wartość nieruchomości

ExportListLabels

ExportOriginalUrlForLinkedImages

Określa, czy oryginalny adres URL powinien być używany jako adres URL powiązanych obrazów.Wyznaczona wartość jest “fałszywa”.

public bool ExportOriginalUrlForLinkedImages { get; set; }

Wartość nieruchomości

bool

Remarks

Jeśli wartość jest ustawiona na Aspose.Words.Drawing.ImageData.SourceFullName wartość jest używana jako URL powiązanych obrazów i powiązanych obrazów nie są pobierane do folderu dokumentu lub Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder.

Jeśli wartość jest ustawiona na powiązane obrazy są przesyłane do folderu dokumentu lub Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder i URL każdego połączonego obrazu jest zbudowany w zależności od mapy dokumentu, __ WL26.

ExportPageMargins

Określa, czy marginy strony są eksportowane do HTML, MHTML lub EPUB.Default jest “fałszywy”.

public bool ExportPageMargins { get; set; }

Wartość nieruchomości

bool

Remarks

Aspose.Words nie wyświetla obszaru marginesów strony wstępnie.Jeśli elementy są całkowicie lub częściowo sklejane przez krawędź dokumentu, wyświetlany obszar może być rozszerzony przezTa opcja .

ExportPageSetup

Określa, czy ustawienie strony jest eksportowane do HTML, MHTML lub EPUB.Default jest “fałszywy”.

public bool ExportPageSetup { get; set; }

Wartość nieruchomości

bool

Remarks

Każdy Aspose.Words.Section w modelu dokumentu Aspose.Words dostarcza informacji o ustawieniu strony za pośrednictwem klasy Aspose.Words.PageSetup.Kiedy eksportujesz dokument do formatu HTML, może to być konieczne, aby utrzymać te informacje do dalszego użytku.W szczególności ustawienie strony może być ważne dla renderowania do mediów paged (tłumaczenia) lub późniejszej konwersji do oryginalnych formatów plików Microsoft Word (DOCX, DOC, RTF, WML).

W większości przypadków HTML jest przeznaczony do przeglądania w przeglądarkach, w których strona nie jest wykonywana.

ExportRelativeFontSize

Określa, czy rozmiary czcionek powinny być wynikiem w relatywnych jednostkach podczas przechowywania do HTML, MHTML lub EPUB.Default jest “fałszywy”.

public bool ExportRelativeFontSize { get; set; }

Wartość nieruchomości

bool

Remarks

W wielu istniejących dokumentach (HTML, IDPF EPUB) rozmiary czcionek są określone w relatywnych jednostkach. To pozwala aplikacjom dostosować rozmiar tekstu podczas przeglądania / przetwarzania dokumentów. Na przykład, Microsoft Internet Explorer ma podmenu “Wid->Size Text”, Adobe Digital Editions ma dwa przyciski: powiększyć / zmniejszyć Rozmiar Tekst. Jeśli oczekujesz, że ta funkcja będzie działać, a następnie ustawić Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontsize właściwości do .

Aspose Words model dokumentu zawiera i działa tylko z absolutnych jednostek wielkości czcionki. Jednostki względne wymagają dodatkowej logiki do ponownego obliczania z niektórych początkowych (standardowych) rozmiarów. Wielkość fontów w stylu dokumentu jest przyjmowana jako standard. Na przykład, jeśli ma 12pt font i jakiś tekst jest 18pt, to będzie wynikiem HTML.

Kiedy ta opcja jest włączona, elementy dokumentów inne niż tekst będzie nadal mieć absolutne rozmiary. Ponadto niektóre atrybuty związane z tekstem mogą być wyrażone absolutnie. W szczególności, przepustowość linii określone z zasadą “dokładnie” może wytwarzać niepożądane wyniki przy skali tekst. Tak więc dokumenty źródłowe powinny być prawidłowo zaprojektowane i przetestowane podczas eksportu z Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize ustawione do .

ExportRoundtripInformation

Określa, czy należy napisać informacje o okrągłej ścieżce podczas przechowywania do HTML, MHTML lub EPUB.Wyznaczona wartość jest “prawdziwa” dla HTML i “fałszywa” dla MHTML i EPUB.

public bool ExportRoundtripInformation { get; set; }

Wartość nieruchomości

bool

Remarks

Oszczędzanie informacji o okrągłej ścieżce pozwala na przywrócenie właściwości dokumentu, takich jak stopy zakładki, komentarze, nagłówki i stopy podczas ładowania dokumentów HTML z powrotem do obiektu Aspose.Words.Document.

W przypadku gdy informacje okrągłe są eksportowane jako -aw-* cechy CSS odpowiednich elementów HTML.

Kiedy , nie powoduje, że informacje okrągłe są wyjściem do wyprodukowanych plików.

ExportShapesAsSvg

Sprawdź, czy węzły Aspose.Words.Drawing.Shape są konwertowane do obrazów SVG podczas przechowywania do HTML, MHTML, EPUB lub AZW3.

public bool ExportShapesAsSvg { get; set; }

Wartość nieruchomości

bool

Remarks

Jeśli ta opcja jest ustawiona na , Aspose.Words.Drawing.Shape węzły są eksportowane jako elementy

ExportTextInputFormFieldAsText

Sprawdza, w jaki sposób pola formularza wejściowego tekstu są zapisywane do HTML lub MHTML.Wyznaczona wartość jest “fałszywa”.

publicboolExportTextInputFormFieldAsText{get;set;}