HtmlSaveOptions

HtmlSaveOptions class

Kan användas för att ange ytterligare alternativ när du sparar ett dokument i Html ,Mhtml ,Epub , Azw3 ellerMobi format.

För att lära dig mer, besökAnge Spara alternativ dokumentationsartikel.

public class HtmlSaveOptions : SaveOptions

Konstruktörer

namn	Beskrivning
HtmlSaveOptions()	Initierar en ny instans av denna klass som kan användas för att spara ett document iHtml format.
HtmlSaveOptions(SaveFormat)	Initierar en ny instans av denna klass som kan användas för att spara ett document iHtml ,Mhtml ,Epub , Azw3 ellerMobi format.

Egenskaper

namn	Beskrivning
AllowEmbeddingPostScriptFonts { get; set; }	Hämtar eller ställer in ett booleskt värde som indikerar om man ska tillåta inbäddning av teckensnitt med PostScript outlines när inbäddning av TrueType-teckensnitt i ett dokument på det sparas. Standardvärdet är`falsk` .
AllowNegativeIndent { get; set; }	Anger om negativa vänster- och högerindrag i stycken normaliseras när du sparar till HTML, MHTML eller EPUB. Standardvärdet är`falsk` .
CssClassNamePrefix { get; set; }	Anger ett prefix som läggs till i 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 document exporteras till HTML. Standard ä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 anpassad lokal tidszon som används för datum-/tidsfält.
DefaultTemplate { get; set; }	Hämtar eller ställer in sökvägen till standardmall (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 bestämmer hur 3D-effekter renderas.
virtual DmlEffectsRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur DrawingML-effekter renderas.
DmlRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer 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 när du sparar tillHtml , Epub ellerAzw3 formatera. Standard ärNone för HTML och HeadingParagraph för EPUB och AZW3.
DocumentSplitHeadingLevel { get; set; }	Anger den maximala nivån för rubriker för att dela dokumentet. Standardvärdet är`2` .
Encoding { get; set; }	Anger kodningen som ska användas vid export till HTML, MHTML eller EPUB. Standardvärdet är`ny UTF8 Encoding(false)` (UTF-8 utan stycklista).
ExportCidUrlsForMhtmlResources { get; set; }	Anger om CID-webbadresser (Content-ID) ska användas för att referera till resurser (bilder, teckensnitt, CSS) som ingår i MHTML -dokument. Standardvärdet är`falsk` .
ExportDocumentProperties { get; set; }	Anger om inbyggda och anpassade dokumentegenskaper ska exporteras till HTML, MHTML eller EPUB. Standardvärdet är`falsk` .
ExportDropDownFormFieldAsText { get; set; }	Styr hur formulärfält i rullgardinsmenyn sparas i HTML eller MHTML. Standardvärdet är`falsk` .
ExportFontResources { get; set; }	Anger om teckensnittsresurser ska exporteras till HTML, MHTML eller EPUB. Standard är`falsk` .
ExportFontsAsBase64 { get; set; }	Anger om teckensnittsresurser ska bäddas in i HTML i Base64-kodning. Standard är`falsk` .
ExportGeneratorName { get; set; }	När`Sann` , gör att namnet och versionen av Aspose.Words bäddas in i producerade filer. Standardvärdet är`Sann` .
ExportHeadersFootersMode { get; set; }	Anger hur sidhuvuden och sidfötter matas ut till 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 till utdata HTML, MHTML eller EPUB. Standard är`falsk` .
ExportLanguageInformation { get; set; }	Anger om språkinformation exporteras till HTML, MHTML eller EPUB. Standard är`falsk` .
ExportListLabels { get; set; }	Styr hur listetiketter matas ut till HTML, MHTML eller EPUB. Standardvärdet ärAuto .
ExportOriginalUrlForLinkedImages { get; set; }	Anger om den ursprungliga webbadressen ska användas som URL för de länkade bilderna. Standardvärdet är`falsk` .
ExportPageMargins { get; set; }	Anger om sidmarginaler exporteras till HTML, MHTML eller EPUB. Standard är`falsk` .
ExportPageSetup { get; set; }	Anger om sidinställningarna exporteras till HTML, MHTML eller EPUB. Standard är`falsk` .
ExportRelativeFontSize { get; set; }	Anger om teckenstorlekar ska matas ut i relativa enheter när du sparar till HTML, MHTML eller EPUB. Standard är`falsk` .
ExportRoundtripInformation { get; set; }	Anger om informationen tur och retur ska skrivas när du sparar till HTML, MHTML eller EPUB. Standardvärdet är`Sann` för HTML och`falsk` för MHTML och EPUB.
ExportShapesAsSvg { get; set; }	Styr om`Shape`noder konverteras till SVG-bilder när save till HTML, MHTML, EPUB eller AZW3. Standardvärdet är`falsk` .
ExportTextInputFormFieldAsText { get; set; }	Styr hur formulärfält för textinmatning sparas i HTML eller MHTML. Standardvärdet är`falsk` .
ExportTocPageNumbers { get; set; }	Anger om sidnummer ska skrivas till innehållsförteckningen när HTML, MHTML och EPUB sparas. Standardvärdet är`falsk` .
ExportXhtmlTransitional { get; set; }	Anger om DOCTYPE-deklarationen ska skrivas när du sparar till HTML eller MHTML. När`Sann` , skriver en DOCTYPE-deklaration i dokumentet före rotelementet. Standardvärdet är`falsk`. När du sparar till EPUB eller HTML5 (Html5 ) DOCTYPE -deklarationen skrivs alltid.
FontResourcesSubsettingSizeThreshold { get; set; }	Styr vilka teckensnittsresurser som behöver underinställning när du sparar till HTML, MHTML eller EPUB. Standard är`0` .
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 mapp där teckensnitt sparas vid export av ett dokument till HTML. Standard är en tom sträng.
FontsFolderAlias { get; set; }	Anger namnet på mappen som används för att konstruera teckensnitts-URI:er inskrivna i ett HTML-dokument. Standard är en tom sträng.
HtmlVersion { get; set; }	Anger version av HTML-standarden som ska användas när dokumentet sparas till HTML eller MHTML. Standardvärdet ärXhtml .
ImageResolution { get; set; }	Anger utdataupplösningen för bilder vid export till HTML, MHTML eller EPUB. Standard är`96 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 vid export av ett dokument till HTML-format. Standard är en tom sträng.
ImagesFolderAlias { get; set; }	Anger namnet på mappen som används för att konstruera bild-URI:er inskrivna i ett HTML-dokument. Standard är en tom sträng.
ImlRenderingMode { get; set; }	Hämtar eller ställer in ett värde som bestämmer hur bläckobjekt (InkML) renderas.
MemoryOptimization { get; set; }	Hämtar eller ställer in värde som avgör om minnesoptimering ska utföras innan dokumentet sparas. Standardvärdet för den här egenskapen är`falsk` .
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 för rubriker som fylls på i navigationskartan vid export till formaten EPUB, MOBI eller AZW3 . Standardvärdet är`3` .
OfficeMathOutputMode { get; set; }	Styr hur OfficeMath-objekt exporteras till HTML, MHTML eller EPUB. Standardvärdet ärImage .
PrettyFormat { get; set; }	När`Sann` snygga format utdata där tillämpligt. Standardvärdet är`falsk` .
ProgressCallback { get; set; }	Anropas när ett dokument sparas och accepterar data om lagringsförlopp.
ResolveFontNames { get; set; }	Anger om teckensnittsfamiljnamn som används i dokumentet löses och ersätts enligt `FontSettings` när de skrivs i HTML-baserade format.
ResourceFolder { get; set; }	Anger en fysisk mapp där alla resurser som bilder, typsnitt och extern CSS sparas när ett document exporteras till HTML. Standard är en tom sträng.
ResourceFolderAlias { get; set; }	Anger namnet på mappen som används för att konstruera URI:er för alla resurser som skrivits in i ett HTML-dokument. Standard är en tom sträng.
override SaveFormat { get; set; }	Anger formatet som dokumentet kommer att sparas i om detta sparaalternativ-objekt används. Kan varaHtml ,Mhtml ,Epub , Azw3 ellerMobi .
ScaleImageToShapeSize { get; set; }	Anger om bilder skalas av Aspose.Words till den gränsande formstorleken vid export till HTML, MHTML eller EPUB. Standardvärdet är`Sann` .
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 du sparar till en DOC- eller DOCX-fil. Som standard är denna egenskap`null` och inga temporära filer används.
UpdateCreatedTimeProperty { get; set; }	Hämtar eller ställer in ett värde som avgör om`CreatedTime` egenskapen uppdateras innan du sparar. Standardvärdet är`falsk` ;
UpdateFields { get; set; }	Hämtar eller ställer in 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 är`Sann` .
UpdateLastPrintedProperty { get; set; }	Hämtar eller ställer in ett värde som avgör om`LastPrinted` egenskapen uppdateras innan du sparar.
UpdateLastSavedTimeProperty { get; set; }	Hämtar eller ställer in ett värde som avgör om`LastSavedTime` egenskapen uppdateras innan du sparar.
UseAntiAliasing { get; set; }	Hämtar eller ställer in ett värde som avgör om kantutjämning ska användas eller inte för rendering.
UseHighQualityRendering { get; set; }	Hämtar eller ställer in ett värde som avgör huruvida högkvalitativa (dvs långsamma) renderingsalgoritmer ska användas eller inte.

Exempel

Visar hur man anger mappen för lagring av länkade bilder efter att ha sparats i .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);

// Ställ in 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 du använder en specifik kodning när du sparar ett dokument i .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 utdata .epub-dokument att ha allt innehåll i en HTML-del.
// Ett delat kriterium tillåter oss att segmentera dokumentet i flera HTML-delar.
// Vi kommer att ställa in kriterierna för att dela upp dokumentet i rubriker.
// 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 "Spara"-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-utdata
    // dokument med allt källdokumentets innehåll.
    // Ställ in egenskapen "DocumentSplitCriteria" till "DocumentSplitCriteria.SectionBreak" till
    // spara vårt dokument i flera HTML-filer: en för varje avsnitt.
    options.DocumentSplitCriteria = DocumentSplitCriteria.SectionBreak;

    // Tilldela en anpassad återuppringning 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 kommer vi att få 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 återuppringning som kan anpassa namnet och filsystemets plats för varje bild.
    options.ImageSavingCallback = new SavedImageRename(outFileName);

    doc.Save(ArtifactsDir + outFileName, options);
}

/// <summary>
/// Ställer in anpassade filnamn för utdatadokument som sparoperationen 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 finns två sätt att specificera var Aspose.Words kommer att 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>
/// Ställer in anpassade filnamn för bildfiler som en HTML-konvertering skapar.
/// </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 finns två sätt att specificera var Aspose.Words kommer att spara varje del av dokumentet.
        // 1 - Ange ett filnamn för utdatafilen:
        args.ImageFileName = imageFileName;

        // 2 - Skapa en anpassad ström för utdatafilen:
        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

HtmlOfficeMathOutputMode Enum HtmlVersion Enum