Class HtmlSaveOptions

Navne til: Aspose.Words.Saving Sammensætning: Aspose.Words.dll (25.4.0)

Kan bruges til at angive yderligere muligheder, når du gemmer et dokument iHtml, Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml og Aspose.Words.SaveFormat.Epub,Aspose.Words.SaveFormat.Azw3 eller Aspose.Words.SaveFormat.Mobi format.

For at lære mere, besøg Specify Save Options Dokumentation af artiklen.

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

De arvede medlemmer

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

Initierer en ny instans i denne klasse, der kan bruges til at gemme et dokumenti formatet Aspose.Words.SaveFormat.Html.

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

Initierer en ny instans i denne klasse, der kan bruges til at gemme et dokumenti Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Aspose.Words.SaveFormat.Azw3 eller Aspose.Words.SaveFormat.Mobi format.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

Det kan være Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Der er tale om Aspose.Words.SaveFormat.Azw3 eller Aspose.Words.SaveFormat.Mobi.

Properties

AllowNegativeIndent

Det angiver, om de negative venstre- og højreindinger af afsnit er normaliseret, når de sparer til HTML, MHTML eller EPUB'.

public bool AllowNegativeIndent { get; set; }

Ejendomsværdi

bool

Remarks

Når den negative indent ikke er tilladt, eksporteres den som nulmargin til HTML. Når den negative indent er tilladt, kan et afsnit vises delvist uden for browservinduet.

CssClassNamePrefix

Det angiver en præfix, der er tilføjet til alle CSS-klasser.Standardværdien er en tom linje, og genererede CSS-klassenavn har ingen almindelige fortegnelser.

public string CssClassNamePrefix { get; set; }

Ejendomsværdi

string

Remarks

Hvis denne værdi ikke er tom, vil alle CSS-klasser, der genereres af Aspose.Words, begynde med den angivne præfix. Dette kan være nyttigt, for eksempel, hvis du tilføjer tilpasset CSS til genererede dokumenter og ønsker at forhindre klassenavne konflikter.

Hvis værdien ikke er eller er tom, skal den være en gyldig CSS-identifikator.

Exceptions

ArgumentException

Værdien er ikke tom og er ikke en gyldig CSS-identifikator.

CssSavingCallback

Det giver dig mulighed for at kontrollere, hvordan CSS-stiler gemmes, når et dokument gemmes til HTML, MHTML eller EPUB.

public ICssSavingCallback CssSavingCallback { get; set; }

Ejendomsværdi

ICssSavingCallback

CssStyleSheetFileName

Angiver vejen og navnet på Cascading Style Sheet (CSS) fil, der er skrevet, når et dokumentDet eksporteres til HTML.Default er en tom linje.

public string CssStyleSheetFileName { get; set; }

Ejendomsværdi

string

Remarks

Denne egenskab virker kun, når du gemmer et dokument i HTML-format, og ekstern CSS-stilblad bliver bedt om at bruge Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType.

Hvis denne egenskab er tom, vil CSS-filen blive gemt i samme mappe og med samme navn som HTML-dokumentet, men med udvidelsen “.css.

Hvis kun vej, men ingen filnavne er angivet i denne egenskab, vil CSS-filen blive gemt i den angivne mappe og vil have det samme navn som HTML-dokumentet, men med udvidelsen “.css.

Hvis mappen, der er angivet af denne egenskab, ikke eksisterer, skabes den automatisk, før CSS-filen gemmes.

En anden måde at angive en mappe, hvor ekstern CSS-fil er gemt, er at bruge Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder.

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

CssStyleSheetType

Det angiver, hvordan CSS (Cascading Style Sheet) stiler eksporteres til HTML, MHTML eller EPUB.Standardværdien er Aspose.Words.Saving.CssStyleSheetType.Inline for HTML/MHTML ogAspose.Words.Saving.CssStyleSheetType.External for EPUB.

public CssStyleSheetType CssStyleSheetType { get; set; }

Ejendomsværdi

CssStyleSheetType

Remarks

Spare CSS style sheet til en ekstern fil er kun understøttet, når du sparer til HTML. Når du eksporterer til et af containerformaterne (EPUB eller MHTML) og angiver Aspose.Words.Saving.CssStyleSheetType.External, CSS-fil vil blive encapsuleret i output pakke.

Se også

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

Det giver dig mulighed for at kontrollere, hvordan dokumentdeler gemmes, når et dokument gemmes til HTML eller EPUB.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

Ejendomsværdi

IDocumentPartSavingCallback

DocumentSplitCriteria

Det angiver, hvordan dokumentet skal splittes, når du sparer til Aspose.Words.SaveFormat.Html,Aspose.Words.SaveFormat.Epub eller Aspose.Words.SaveFormat.Azw3 format.Som standard er Aspose.Words.Saving.DocumentSplitCriteria.Nej til HTML ogAspose.Words.Saving.DocumentSplitCriteria.HeadingParagraf til EPUB og AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

Ejendomsværdi

DocumentSplitCriteria

Remarks

Normalt vil du gerne have et dokument, der er gemt til HTML som en enkelt fil. Men i nogle tilfælde er det foretrukket at opdele udgangen i flere mindre HTML-sider. Når du sparer til html-format, vil disse sider være udgang til individuelle filer eller strømme.

Et dokument kan ikke splittes, når det spares i MHTML-format.

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

DocumentSplitHeadingLevel

Angiver det maksimale niveau af overskrifter, hvor du skal splitte dokumentet.Default værdi er ‘2’.

public int DocumentSplitHeadingLevel { get; set; }

Ejendomsværdi

int

Remarks

Når Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria omfatter __ WL26.DOCUMENTSPLit.HeadingParagraph og denne egenskab er indstillet til en værdi fra 1 til 9, vil dokumentet blive opdelt i afsnit formateret ved hjælp af , etc. styler op til det angivne overskrift niveau.

Ved standard, kun og afsnit forårsager dokumentet til at blive splittet. At sætte denne ejendom til null vil føre til, at documentet ikke skal blive opdelt i overskrifterne i det hele taget.

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

Encoding

Specifikerer kodningen til brug, når du eksporterer til HTML, MHTML eller EPUB.Default værdi er ’new UTF8Encoding(false)’ (UTF-8 uden BOM).

public Encoding Encoding { get; set; }

Ejendomsværdi

Encoding

ExportCidUrlsForMhtmlResources

Det angiver, om du skal bruge CID (Content-ID) URL’er til reference ressourcer (billeder, bogstaver, CSS) inkluderet i MHTML-dokumenter'.

public bool ExportCidUrlsForMhtmlResources { get; set; }

Ejendomsværdi

bool

Remarks

Denne mulighed påvirker kun dokumenter, der gemmes i MHTML.

Som standard er ressourcer i MHTML-dokumenter henvist til filnavnet (f.eks. “image.png”), som er matchet mod “Content-Location” overskrifter af MIME-dele.

Denne mulighed giver mulighed for en alternativ metode, hvor referencer til ressourcefiler er skrevet som CID (Content-ID) URL’er (for eksempel “cid:image.png”) og er matchet mod “Content-ID” overskrifter.

I teorien bør der ikke være forskel mellem de to referencemetoder og hver af dem bør fungere godt i enhver browser eller mail agent. I praksis, dog, nogle agenter mislykkes at fatte ressourcer ved filnavne. Hvis din browser eller mail agent nægter at oplade ressourcerne inkluderet i et MTHML dokument (der ikke viser billeder eller ikke oplader CSS stilarter), prøv at eksportere dokumentet med CID URL’er.

ExportDocumentProperties

Det angiver, om du skal eksportere indbyggede og tilpassede dokumentegenskaber til HTML, MHTML eller EPUB.Default værdi er ‘falsk’.

public bool ExportDocumentProperties { get; set; }

Ejendomsværdi

bool

ExportDropDownFormFieldAsText

Kontroller, hvordan drop-down-formulære felter er gemt til HTML eller MHTML.Default værdi er ‘falsk’.

public bool ExportDropDownFormFieldAsText { get; set; }

Ejendomsværdi

bool

Remarks

Når det er indstillet til, eksporterer drop-down form felter som normal tekst. Når, eksporterer drop-down form felter som SELECT element i HTML.

Når du eksporterer til EPUB, er tekst drop-down formfelter altid gemt som tekst på grund af kravene til dette format.

ExportFontResources

Det angiver, om fontressourcerne skal eksporteres til HTML, MHTML eller EPUB.Default er ‘falsk’.

public bool ExportFontResources { get; set; }

Ejendomsværdi

bool

Remarks

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

Hvis Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources er indstillet til , den vigtigste HTML-dokument vil henvise til hver font via CSS 3 i regel og fonts vil blive udgivet som separate filer.

Hvis Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 er indstillet til, vil bogstaverne ikke blive gemt til separate filer.

Når der eksporteres fontressourcer, bør der tages hensyn til font licensproblemer. Forfattere, der ønsker at bruge specifikke fonts via en downloadbar font mekanisme, skal altid nøje kontrollere, at deres hensigtsmæssige brug er inden for rammerne af font lisens. Mange kommercielle fonter i øjeblikket ikke tillader web downloading af deres font i nogen form. Licensavtalen, som dækker nogle Fonts specifikt bemærke, det brug via regler i CSS stillister er ikke lovligt. Font subset kan også krænke licensen betingelser.

Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

Det angiver, om fontressourcerne skal indlejres i HTML i Base64 kodning.Default er ‘falsk’.

public bool ExportFontsAsBase64 { get; set; }

Ejendomsværdi

bool

Remarks

Hvis dette alternativ er indstillet til, vil bogstaverne blive indlejret i dokumentets CSS i Base64 kodning.

ExportHeadersFootersMode

Det angiver, hvordan header og foder er udgang til HTML, MHTML eller EPUB.Standardværdien er Aspose.Words.Saving.ExportHeadersFootersMode.PerSection for HTML/MHTMLog Aspose.Words.Saving.ExportHeadersFootersMode.Nej til EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

Ejendomsværdi

ExportHeadersFootersMode

Remarks

Det er svært at betænkeligt udstede overskrifter og foder til HTML, fordi HTML ikke er pagineret.

Når denne ejendom er Aspose.Words.Saving.ExportHeadersFootersMode.PerSection, eksporterer Aspose.Words kun primære header og foder i begyndelsen og slutningen af hver sektion.

Når det er Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectFooter kun den første primære header og den sidste primær footer (herunder linket til tidligere) eksporteres.

Du kan deaktivere eksporten af hoved og foder helt ved at indstille denne ejendom til Aspose.Words.Saving.ExportHeadersFootersMode.None.

ExportImagesAsBase64

Det angiver, om billeder er gemt i Base64 format til udgangen HTML, MHTML eller EPUB.Default er ‘falsk’.

public bool ExportImagesAsBase64 { get; set; }

Ejendomsværdi

bool

Remarks

Når denne egenskab er indstillet til billederne, eksporteres data direkte til elementerne og separate filer skabes ikke.

ExportLanguageInformation

Det angiver, om sprogoplysninger eksporteres til HTML, MHTML eller EPUB.Default er ‘falsk’.

public bool ExportLanguageInformation { get; set; }

Ejendomsværdi

bool

Remarks

Når denne egenskab er indstillet til Aspose.Words udkommer HTML-attribut på de dokumentelementer, der angiver sprog.

ExportListLabels

Kontroller, hvordan listeetiketter udkommer til HTML, MHTML eller EPUB.Standardværdien er Aspose.Words.Saving.ExportListLabels.Auto.

public ExportListLabels ExportListLabels { get; set; }

Ejendomsværdi

ExportListLabels

ExportOriginalUrlForLinkedImages

Det angiver, om den oprindelige URL skal bruges som URL’en for de linkede billeder.Default værdi er ‘falsk’.

public bool ExportOriginalUrlForLinkedImages { get; set; }

Ejendomsværdi

bool

Remarks

Hvis værdien er indstillet til Aspose.Words.Drawing.ImageData.SourceFullName værdien bruges som URL’en for linkede billeder og linkede billeder lades ikke ind i dokumentets mappe eller Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder.

Hvis værdien er indstillet til linkede billeder oplades i dokumentets mappe eller Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder og URL af hvert linket billede er konstrueret afhængigt af dokumentens mappen, __ WL27__ .Swing.MadGiveOption.Imagesfoldere og Wl26.

ExportPageMargins

Det angiver, om sidemarginerne eksporteres til HTML, MHTML eller EPUB.Default er ‘falsk’.

public bool ExportPageMargins { get; set; }

Ejendomsværdi

bool

Remarks

Aspose.Words viser ikke et område af sidemarginer som standard.Hvis alle elementer er helt eller delvist klippet af dokumentets edge, kan det vist område udvides medDenne mulighed.

ExportPageSetup

Det angiver, om sidesætningen eksporteres til HTML, MHTML eller EPUB.Default er ‘falsk’.

public bool ExportPageSetup { get; set; }

Ejendomsværdi

bool

Remarks

Hver Aspose.Words.Section i Aspose.Words-dokumentmodellen giver sideindstilling information via Aspose.Words.PageSetup klasse. Når du eksporterer et dokument til HTML-format, kan du behøve at opbevare denne information til yderligere brug. I særdeleshed, sideindstilling kan være vigtigt for rendering til pagede medier (printing) eller efterfølgende konvertering til de indfødte Microsoft Word-filformater (DOCX, DOC, RTF, WML).

I de fleste tilfælde er HTML beregnet til at se i browsere, hvor siden ikke udføres.

ExportRelativeFontSize

Det angiver, om fontstørrelser skal være udgang i relative enheder, når du sparer til HTML, MHTML eller EPUB.Default er ‘falsk’.

public bool ExportRelativeFontSize { get; set; }

Ejendomsværdi

bool

Remarks

I mange eksisterende dokumenter (HTML, IDPF EPUB) bogstaverne er angivet i relative enheder. Dette gør det muligt for applikationer at justere tekststørrelse, når du ser/behandler dokumenterne. For eksempel, Microsoft Internet Explorer har “View->Text Size” undermenu, Adobe Digital Editions har to knapper: Øge/Skræver Text Size. Hvis du forventer denne funktionalitet til at arbejde så indstille Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize egenskab til .

Aspose Words dokument model indeholder og fungerer kun med absolutte font størrelse enheder. Relative enheter har brug for yderligere logik til at genberegnes fra nogle oprindelige (standard) størrelse. Font størrelse af dokument stil tages som standard. For eksempel, hvis der er 12pt font og nogle tekst er 18pt så det vil være udgang i forhold til HTML.

Når denne mulighed er aktiveret, dokument elementer andre end tekst vil stadig have absolutte størrelser. Også nogle tekstrelaterede attributter kan udtrykkes absolut. I særdeleshed, linje spacing angivet med “exakt” regel kan producere uønskede resultater, når skalering tekst. Så kilden dokumenter skal være korrekt designet og testet ved eksport med Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize indstillet til .

ExportRoundtripInformation

Det angiver, om du skal skrive den rundtrip information, når du sparer til HTML, MHTML eller EPUB.Default værdi er ’true’ for HTML og ‘false’ for MHTML og EPUB.

public bool ExportRoundtripInformation { get; set; }

Ejendomsværdi

bool

Remarks

Sparing af rundtrip-oplysninger giver dig mulighed for at genoprette dokumentegenskaber såsom tab stops, kommentarer, overskrifter og foder, mens HTML-dokumenter lades tilbage til et Aspose.Words.Document-objekt.

Når, den rundtrip information eksporteres som -aw-* CSS egenskaber af de tilsvarende HTML elementer.

Når, forårsager ingen rundtrip information til at være output i producerede filer.

ExportShapesAsSvg

Kontroller, om Aspose.Words.Drawing.Shape noder konverteres til SVG-billeder, når de spares til HTML, MHTML, EPUB eller AZW3.Default værdi er ‘falsk’.

public bool ExportShapesAsSvg { get; set; }

Ejendomsværdi

bool

Remarks

Hvis denne indstilling er indstillet til , Aspose.Words.Drawing.Shape knudler eksporteres somelementerne.

ExportTextInputFormFieldAsText

Kontroller, hvordan tekstindgangsformulære felter er gemt til HTML eller MHTML.Default værdi er ‘falsk’.

publicboolExportTextInputFormFieldAsText{get;set;}