HtmlSaveOptions

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

namnBeskrivning
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

namnBeskrivning
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 omShapenoder 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