HtmlSaveOptions
Innehåll
[
Dölj
]HtmlSaveOptions class
Kan användas för att ange ytterligare alternativ när ett dokument sparas i Html ,Mhtml ,Epub , Azw3 ellerMobi format.
För att lära dig mer, besökAnge alternativ för sparning dokumentationsartikel.
public class HtmlSaveOptions : SaveOptions
Konstruktörer
namn | Beskrivning |
---|---|
HtmlSaveOptions() | Initierar en ny instans av den här klassen som kan användas för att spara ett dokument iHtml format. |
HtmlSaveOptions(SaveFormat) | Initierar en ny instans av den här klassen som kan användas för att spara ett dokument iHtml ,Mhtml ,Epub , Azw3 ellerMobi format. |
Egenskaper
namn | Beskrivning |
---|---|
AllowEmbeddingPostScriptFonts { get; set; } | Hämtar eller ställer in ett booleskt värde som anger om inbäddning av teckensnitt med PostScript-konturer ska tillåtas när TrueType-teckensnitt bäddas in i ett dokument när det sparas. Standardvärdet ärfalsk . |
AllowNegativeIndent { get; set; } | Anger om negativa vänster- och högerindrag i stycken normaliseras när de sparas i HTML, MHTML eller EPUB. Standardvärdet ärfalsk . |
CssClassNamePrefix { get; set; } | Anger ett prefix som läggs till alla CSS-klassnamn. Standardvärdet är en tom sträng och genererade CSS-klassnamn har inget gemensamt prefix. |
CssSavingCallback { get; set; } | Gör det möjligt att styra hur CSS-stilar sparas när ett dokument sparas i HTML, MHTML eller EPUB. |
CssStyleSheetFileName { get; set; } | Anger sökvägen och namnet på CSS-filen (Cascading Style Sheet) som skrivs när ett dokument exporteras till HTML. Standardvärdet är en tom sträng. |
CssStyleSheetType { get; set; } | Anger hur CSS-stilar (Cascading Style Sheet) exporteras till HTML, MHTML eller EPUB. Standardvärdet ärInline för HTML/MHTML och External för EPUB. |
CustomTimeZoneInfo { get; set; } | Hämtar eller ställer in en anpassad lokal tidszon som används för datum-/tidsfält. |
DefaultTemplate { get; set; } | Hämtar eller anger sökvägen till standardmallen (inklusive filnamn). Standardvärdet för den här egenskapen ärtom sträng (Empty ). |
Dml3DEffectsRenderingMode { get; set; } | Hämtar eller ställer in ett värde som avgör hur 3D-effekter renderas. |
virtual DmlEffectsRenderingMode { get; set; } | Hämtar eller ställer in ett värde som avgör hur DrawingML-effekter renderas. |
DmlRenderingMode { get; set; } | Hämtar eller ställer in ett värde som avgör hur DrawingML-former renderas. |
DocumentPartSavingCallback { get; set; } | Gör det möjligt att styra hur dokumentdelar sparas när ett dokument sparas i HTML eller EPUB. |
DocumentSplitCriteria { get; set; } | Anger hur dokumentet ska delas upp när det sparas tillHtml , Epub ellerAzw3 format. Standard ärNone för HTML och HeadingParagraph för EPUB och AZW3. |
DocumentSplitHeadingLevel { get; set; } | Anger den maximala rubriknivån där dokumentet ska delas. Standardvärdet är2 . |
Encoding { get; set; } | Anger vilken kodning som ska användas vid export till HTML, MHTML eller EPUB. Standardvärdet ärny UTF8-kodning(falsk) (UTF-8 utan BOM). |
ExportCidUrlsForMhtmlResources { get; set; } | Anger om CID-URL:er (Content-ID) ska användas för att referera till resurser (bilder, teckensnitt, CSS) som ingår i MHTML -dokument. Standardvärdet ärfalsk . |
ExportDocumentProperties { get; set; } | Anger om inbyggda och anpassade dokumentegenskaper ska exporteras till HTML, MHTML eller EPUB. Standardvärdet ärfalsk . |
ExportDropDownFormFieldAsText { get; set; } | Styr hur rullgardinsmenyfält sparas i HTML eller MHTML. Standardvärdet ärfalsk . |
ExportFontResources { get; set; } | Anger om teckensnittsresurser ska exporteras till HTML, MHTML eller EPUB. Standard ärfalsk . |
ExportFontsAsBase64 { get; set; } | Anger om teckensnittsresurser ska bäddas in i HTML i Base64-kodning. Standard ärfalsk . |
ExportGeneratorName { get; set; } | Närsann , gör att namnet och versionen av Aspose.Words bäddas in i producerade filer. Standardvärdet ärsann . |
ExportHeadersFootersMode { get; set; } | Anger hur sidhuvuden och sidfot visas som HTML, MHTML eller EPUB. Standardvärdet ärPerSection för HTML/MHTML ochNone för EPUB. |
ExportImagesAsBase64 { get; set; } | Anger om bilder sparas i Base64-format som utdata i HTML, MHTML eller EPUB. Standard ärfalsk . |
ExportLanguageInformation { get; set; } | Anger om språkinformation exporteras till HTML, MHTML eller EPUB. Standard ärfalsk . |
ExportListLabels { get; set; } | Styr hur listetiketter matas ut till HTML, MHTML eller EPUB. Standardvärdet ärAuto . |
ExportOriginalUrlForLinkedImages { get; set; } | Anger om original-URL:en ska användas som URL för de länkade bilderna. Standardvärdet ärfalsk . |
ExportPageMargins { get; set; } | Anger om sidmarginaler exporteras till HTML, MHTML eller EPUB. Standard ärfalsk . |
ExportPageSetup { get; set; } | Anger om utskriftsformatet exporteras till HTML, MHTML eller EPUB. Standard ärfalsk . |
ExportRelativeFontSize { get; set; } | Anger om teckenstorlekar ska matas ut i relativa enheter när man sparar till HTML, MHTML eller EPUB. Standard ärfalsk . |
ExportRoundtripInformation { get; set; } | Anger om returinformationen ska skrivas när man sparar till HTML, MHTML eller EPUB. Standardvärdet ärsann för HTML ochfalsk för MHTML och EPUB. |
ExportShapesAsSvg { get; set; } | Kontrollerar omShape noder konverteras till SVG-bilder när de sparas till HTML, MHTML, EPUB eller AZW3. Standardvärdet ärfalsk . |
ExportTextInputFormFieldAsText { get; set; } | Styr hur textinmatningsfält sparas i HTML eller MHTML. Standardvärdet ärfalsk . |
ExportTocPageNumbers { get; set; } | Anger om sidnummer ska skrivas till innehållsförteckningen när HTML, MHTML och EPUB sparas. Standardvärdet ärfalsk . |
ExportXhtmlTransitional { get; set; } | Anger om DOCTYPE-deklarationen ska skrivas när man sparar till HTML eller MHTML. Närsann , skriver en DOCTYPE-deklaration i dokumentet före rotelementet. Standardvärdet ärfalsk . När du sparar till EPUB eller HTML5 (Html5 ) DOCTYPE -deklarationen skrivs alltid. |
FontResourcesSubsettingSizeThreshold { get; set; } | Styr vilka teckensnittsresurser som behöver delinställningar när man sparar till HTML, MHTML eller EPUB. Standard är0 . |
FontSavingCallback { get; set; } | Gör det möjligt att styra hur teckensnitt sparas när ett dokument sparas i HTML, MHTML eller EPUB. |
FontsFolder { get; set; } | Anger den fysiska mappen där teckensnitt sparas när ett dokument exporteras till HTML. Standardvärdet är en tom sträng. |
FontsFolderAlias { get; set; } | Anger namnet på mappen som används för att konstruera teckensnitts-URI:er som skrivs in i ett HTML-dokument. Standardvärdet är en tom sträng. |
HtmlVersion { get; set; } | Anger vilken version av HTML-standarden som ska användas när dokumentet sparas som HTML eller MHTML. Standardvärdet ärXhtml . |
ImageResolution { get; set; } | Anger utdataupplösningen för bilder vid export till HTML, MHTML eller EPUB. Standard är96 dpi . |
ImageSavingCallback { get; set; } | Gör det möjligt att styra hur bilder sparas när ett dokument sparas i HTML, MHTML eller EPUB. |
ImagesFolder { get; set; } | Anger den fysiska mappen där bilder sparas när ett dokument exporteras till HTML-format. Standardvärdet är en tom sträng. |
ImagesFolderAlias { get; set; } | Anger namnet på mappen som används för att konstruera bild-URI:er som skrivs in i ett HTML-dokument. Standardvärdet är en tom sträng. |
ImlRenderingMode { get; set; } | Hämtar eller ställer in ett värde som avgör hur bläckobjekt (InkML) renderas. |
MemoryOptimization { get; set; } | Hämtar eller anger värde som avgör om minnesoptimering ska utföras innan dokumentet sparas. Standardvärdet för den här egenskapen ärfalsk . |
MetafileFormat { get; set; } | Anger i vilket format metafiler sparas vid export till HTML, MHTML eller EPUB. Standardvärdet ärPng , vilket betyder att metafiler renderas till raster-PNG-bilder. |
NavigationMapLevel { get; set; } | Anger den maximala nivån av rubriker som fylls i navigeringskartan vid export till EPUB-, MOBI- eller AZW3 -format. Standardvärdet är3 . |
OfficeMathOutputMode { get; set; } | Styr hur OfficeMath-objekt exporteras till HTML, MHTML eller EPUB. Standardvärdet ärImage . |
PrettyFormat { get; set; } | Närsann , pretty formats output där det är tillämpligt. Standardvärdet ärfalsk . |
ProgressCallback { get; set; } | Anropas när ett dokument sparas och accepterar data om sparningsförloppet. |
RemoveJavaScriptFromLinks { get; set; } | Anger om JavaScript ska tas bort från länkar. Standard ärfalsk . |
ReplaceBackslashWithYenSign { get; set; } | Anger om bakåtsnedstreck ska ersättas med yen-tecken. Standardvärdet ärfalsk . |
ResolveFontNames { get; set; } | Anger om teckensnittsfamiljenamn som används i dokumentet är upplösta och ersatta enligt FontSettings när det skrivs till HTML-baserade format. |
ResourceFolder { get; set; } | Anger en fysisk mapp där alla resurser som bilder, teckensnitt och extern CSS sparas när ett dokument exporteras till HTML. Standardvärdet är en tom sträng. |
ResourceFolderAlias { get; set; } | Anger namnet på den mapp som används för att konstruera URI:er för alla resurser som skrivs in i ett HTML-dokument. Standardvärdet är en tom sträng. |
override SaveFormat { get; set; } | Anger formatet som dokumentet sparas i om detta objekt för sparade alternativ används. Kan varaHtml ,Mhtml ,Epub , Azw3 ellerMobi . |
ScaleImageToShapeSize { get; set; } | Anger om bilder skalas av Aspose.Words till den avgränsande formstorleken vid export till HTML, MHTML eller EPUB. Standardvärdet ärsann . |
TableWidthOutputMode { get; set; } | Styr hur tabell-, rad- och cellbredder exporteras till HTML, MHTML eller EPUB. Standardvärdet ärAll . |
TempFolder { get; set; } | Anger mappen för temporära filer som används när man sparar till en DOC- eller DOCX-fil. Som standard är den här egenskapennull och inga temporära filer används. |
UpdateAmbiguousTextFont { get; set; } | Avgör om teckensnittsattributen ska ändras beroende på den teckenkod som används. |
UpdateCreatedTimeProperty { get; set; } | Hämtar eller ställer in ett värde som avgör omCreatedTime egenskapen uppdateras innan den sparas. Standardvärdet ärfalsk ; |
UpdateFields { get; set; } | Hämtar eller anger ett värde som avgör om fält av vissa typer ska uppdateras innan dokumentet sparas till ett fast sidformat. Standardvärdet för den här egenskapen ärsann . |
UpdateLastPrintedProperty { get; set; } | Hämtar eller ställer in ett värde som avgör omLastPrinted egenskapen uppdateras innan den sparas. |
UpdateLastSavedTimeProperty { get; set; } | Hämtar eller ställer in ett värde som avgör omLastSavedTime egenskapen uppdateras innan den sparas. |
UseAntiAliasing { get; set; } | Hämtar eller ställer in ett värde som avgör om antialiasing ska användas för rendering. |
UseHighQualityRendering { get; set; } | Hämtar eller ställer in ett värde som avgör om högkvalitativa (dvs. långsamma) renderingsalgoritmer ska användas eller inte. |
Exempel
Visar hur man anger mappen för att lagra länkade bilder efter att de har sparats till .html.
Document doc = new Document(MyDir + "Rendering.docx");
string imagesDir = Path.Combine(ArtifactsDir, "SaveHtmlWithOptions");
if (Directory.Exists(imagesDir))
Directory.Delete(imagesDir, true);
Directory.CreateDirectory(imagesDir);
// Ange ett alternativ för att exportera formulärfält som vanlig text istället för HTML-inmatningselement.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Html)
{
ExportTextInputFormFieldAsText = true,
ImagesFolder = imagesDir
};
doc.Save(ArtifactsDir + "HtmlSaveOptions.SaveHtmlWithOptions.html", options);
Visar hur man använder en specifik kodning när man sparar ett dokument till .epub.
Document doc = new Document(MyDir + "Rendering.docx");
// Använd ett SaveOptions-objekt för att ange kodningen för ett dokument som vi ska spara.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.SaveFormat = SaveFormat.Epub;
saveOptions.Encoding = Encoding.UTF8;
// Som standard kommer ett .epub-dokument att ha allt innehåll i en HTML-del.
// Ett delningskriterium låter oss segmentera dokumentet i flera HTML-delar.
// Vi kommer att ställa in kriterierna för att dela upp dokumentet i rubrikstycken.
// Detta är användbart för läsare som inte kan läsa HTML-filer som är större än en viss storlek.
saveOptions.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;
// Ange att vi vill exportera dokumentegenskaper.
saveOptions.ExportDocumentProperties = true;
doc.Save(ArtifactsDir + "HtmlSaveOptions.Doc2EpubSaveOptions.epub", saveOptions);
Visar hur man delar upp ett dokument i delar och sparar dem.
public void DocumentPartsFileNames()
{
Document doc = new Document(MyDir + "Rendering.docx");
string outFileName = "SavingCallback.DocumentPartsFileNames.html";
// Skapa ett "HtmlFixedSaveOptions"-objekt, som vi kan skicka till dokumentets "Save"-metod
// för att ändra hur vi konverterar dokumentet till HTML.
HtmlSaveOptions options = new HtmlSaveOptions();
// Om vi sparar dokumentet normalt kommer det att finnas en HTML-utgång
// dokument med allt innehåll i källdokumentet.
// Ställ in egenskapen "DocumentSplitCriteria" till "DocumentSplitCriteria.SectionBreak" till
// spara vårt dokument till flera HTML-filer: en för varje avsnitt.
options.DocumentSplitCriteria = DocumentSplitCriteria.SectionBreak;
// Tilldela en anpassad återanropning till egenskapen "DocumentPartSavingCallback" för att ändra logiken för att spara dokumentdelen.
options.DocumentPartSavingCallback = new SavedDocumentPartRename(outFileName, options.DocumentSplitCriteria);
// Om vi konverterar ett dokument som innehåller bilder till html, får vi en html-fil som länkar till flera bilder.
// Varje bild kommer att vara i form av en fil i det lokala filsystemet.
// Det finns också en återanropsfunktion som kan anpassa namn och filsystemplats för varje bild.
options.ImageSavingCallback = new SavedImageRename(outFileName);
doc.Save(ArtifactsDir + outFileName, options);
}
/// <summary>
/// Anger anpassade filnamn för utdatadokument som sparandet delar upp ett dokument i.
/// </summary>
private class SavedDocumentPartRename : IDocumentPartSavingCallback
{
public SavedDocumentPartRename(string outFileName, DocumentSplitCriteria documentSplitCriteria)
{
mOutFileName = outFileName;
mDocumentSplitCriteria = documentSplitCriteria;
}
void IDocumentPartSavingCallback.DocumentPartSaving(DocumentPartSavingArgs args)
{
// Vi kan komma åt hela källdokumentet via egenskapen "Dokument".
Assert.True(args.Document.OriginalFileName.EndsWith("Rendering.docx"));
string partType = string.Empty;
switch (mDocumentSplitCriteria)
{
case DocumentSplitCriteria.PageBreak:
partType = "Page";
break;
case DocumentSplitCriteria.ColumnBreak:
partType = "Column";
break;
case DocumentSplitCriteria.SectionBreak:
partType = "Section";
break;
case DocumentSplitCriteria.HeadingParagraph:
partType = "Paragraph from heading";
break;
}
string partFileName = $"{mOutFileName} part {++mCount}, of type {partType}{Path.GetExtension(args.DocumentPartFileName)}";
// Nedan följer två sätt att ange var Aspose.Words ska spara varje del av dokumentet.
// 1 - Ange ett filnamn för utdatafilen:
args.DocumentPartFileName = partFileName;
// 2 - Skapa en anpassad ström för utdatafilen:
args.DocumentPartStream = new FileStream(ArtifactsDir + partFileName, FileMode.Create);
Assert.True(args.DocumentPartStream.CanWrite);
Assert.False(args.KeepDocumentPartStreamOpen);
}
private int mCount;
private readonly string mOutFileName;
private readonly DocumentSplitCriteria mDocumentSplitCriteria;
}
/// <summary>
/// Anger anpassade filnamn för bildfiler som skapas vid en HTML-konvertering.
/// </summary>
public class SavedImageRename : IImageSavingCallback
{
public SavedImageRename(string outFileName)
{
mOutFileName = outFileName;
}
void IImageSavingCallback.ImageSaving(ImageSavingArgs args)
{
string imageFileName = $"{mOutFileName} shape {++mCount}, of type {args.CurrentShape.ShapeType}{Path.GetExtension(args.ImageFileName)}";
// Nedan följer två sätt att ange var Aspose.Words ska spara varje del av dokumentet.
// 1 - Ange ett filnamn för bildfilen som visas:
args.ImageFileName = imageFileName;
// 2 - Skapa en anpassad ström för utdatabildfilen:
args.ImageStream = new FileStream(ArtifactsDir + imageFileName, FileMode.Create);
Assert.True(args.ImageStream.CanWrite);
Assert.True(args.IsImageAvailable);
Assert.False(args.KeepImageStreamOpen);
}
private int mCount;
private readonly string mOutFileName;
}
Se även
- class SaveOptions
- namnutrymme Aspose.Words.Saving
- hopsättning Aspose.Words