HtmlSaveOptions

HtmlSaveOptions class

Può essere utilizzato per specificare opzioni aggiuntive quando si salva un documento in Html ,Mhtml ,Epub , Azw3 OMobi formato.

Per saperne di più, visita ilSpecificare le opzioni di salvataggio articolo di documentazione.

public class HtmlSaveOptions : SaveOptions

Costruttori

Nome	Descrizione
HtmlSaveOptions()	Inizializza una nuova istanza di questa classe che può essere utilizzata per salvare un documento nelHtml formato.
HtmlSaveOptions(SaveFormat)	Inizializza una nuova istanza di questa classe che può essere utilizzata per salvare un documento nelHtml ,Mhtml ,Epub , Azw3 OMobi formato.

Proprietà

Nome	Descrizione
AllowEmbeddingPostScriptFonts { get; set; }	Ottiene o imposta un valore booleano che indica se consentire l’incorporamento di font con contorni PostScript quando si incorporano font TrueType in un documento al momento del salvataggio. Il valore predefinito è`falso` .
AllowNegativeIndent { get; set; }	Specifica se i rientri negativi a sinistra e a destra dei paragrafi vengono normalizzati quando si salva in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
CssClassNamePrefix { get; set; }	Specifica un prefisso che viene aggiunto a tutti i nomi delle classi CSS. Il valore predefinito è una stringa vuota e i nomi delle classi CSS generati non hanno un prefisso comune.
CssSavingCallback { get; set; }	Consente di controllare come vengono salvati gli stili CSS quando un documento viene salvato in HTML, MHTML o EPUB.
CssStyleSheetFileName { get; set; }	Specifica il percorso e il nome del file Cascading Style Sheet (CSS) scritto quando un documento viene esportato in HTML. Il valore predefinito è una stringa vuota.
CssStyleSheetType { get; set; }	Specifica come gli stili CSS (Cascading Style Sheet) vengono esportati in HTML, MHTML o EPUB. Il valore predefinito èInline per HTML/MHTML e External per EPUB.
CustomTimeZoneInfo { get; set; }	Ottiene o imposta il fuso orario locale personalizzato utilizzato per i campi data/ora.
DefaultTemplate { get; set; }	Ottiene o imposta il percorso al modello predefinito (incluso il nome del file). Il valore predefinito per questa proprietà èstringa vuota (Empty ).
Dml3DEffectsRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzati gli effetti 3D.
virtual DmlEffectsRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzati gli effetti DrawingML.
DmlRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzate le forme DrawingML.
DocumentPartSavingCallback { get; set; }	Consente di controllare come vengono salvate le parti del documento quando un documento viene salvato in formato HTML o EPUB.
DocumentSplitCriteria { get; set; }	Specifica come il documento deve essere diviso durante il salvataggioHtml , Epub OAzw3 format. Il valore predefinito èNone per HTML e HeadingParagraph per EPUB e AZW3.
DocumentSplitHeadingLevel { get; set; }	Specifica il livello massimo di intestazioni in cui dividere il documento. Il valore predefinito è`2` .
Encoding { get; set; }	Specifica la codifica da utilizzare durante l’esportazione in HTML, MHTML o EPUB. Il valore predefinito è`nuova codifica UTF8(false)` (UTF-8 senza BOM).
ExportCidUrlsForMhtmlResources { get; set; }	Specifica se utilizzare URL CID (Content-ID) per fare riferimento a risorse (immagini, font, CSS) incluse nei documenti MHTML . Il valore predefinito è`falso` .
ExportDocumentProperties { get; set; }	Specifica se esportare le proprietà del documento personalizzate e integrate in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportDropDownFormFieldAsText { get; set; }	Controlla come i campi del modulo a discesa vengono salvati in HTML o MHTML. Il valore predefinito è`falso` .
ExportFontResources { get; set; }	Specifica se le risorse dei font devono essere esportate in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportFontsAsBase64 { get; set; }	Specifica se le risorse dei font devono essere incorporate in HTML nella codifica Base64. Il valore predefinito è`falso` .
ExportGeneratorName { get; set; }	Quando`VERO` , fa sì che il nome e la versione di Aspose.Words vengano incorporati nei file prodotti. Il valore predefinito è`VERO` .
ExportHeadersFootersMode { get; set; }	Specifica come le intestazioni e i piè di pagina vengono emessi in HTML, MHTML o EPUB. Il valore predefinito èPerSection per HTML/MHTML eNone per EPUB.
ExportImagesAsBase64 { get; set; }	Specifica se le immagini vengono salvate in formato Base64 nell’output HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportLanguageInformation { get; set; }	Specifica se le informazioni sulla lingua vengono esportate in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportListLabels { get; set; }	Controlla come le etichette degli elenchi vengono emesse in HTML, MHTML o EPUB. Il valore predefinito èAuto .
ExportOriginalUrlForLinkedImages { get; set; }	Specifica se l’URL originale deve essere utilizzato come URL delle immagini collegate. Il valore predefinito è`falso` .
ExportPageMargins { get; set; }	Specifica se i margini della pagina vengono esportati in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportPageSetup { get; set; }	Specifica se l’impostazione di pagina viene esportata in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportRelativeFontSize { get; set; }	Specifica se le dimensioni del carattere devono essere emesse in unità relative quando si salva in HTML, MHTML o EPUB. Il valore predefinito è`falso` .
ExportRoundtripInformation { get; set; }	Specifica se scrivere le informazioni di andata e ritorno durante il salvataggio in HTML, MHTML o EPUB. Il valore predefinito è`VERO` per HTML e`falso` per MHTML ed EPUB.
ExportShapesAsSvg { get; set; }	Controlla se`Shape` nodi vengono convertiti in immagini SVG quando si salva in HTML, MHTML, EPUB o AZW3. Il valore predefinito è`falso` .
ExportTextInputFormFieldAsText { get; set; }	Controlla come i campi del modulo di input di testo vengono salvati in HTML o MHTML. Il valore predefinito è`falso` .
ExportTocPageNumbers { get; set; }	Specifica se scrivere i numeri di pagina nel sommario quando si salva HTML, MHTML ed EPUB. Il valore predefinito è`falso` .
ExportXhtmlTransitional { get; set; }	Specifica se scrivere la dichiarazione DOCTYPE durante il salvataggio in HTML o MHTML. Quando`VERO` , scrive una dichiarazione DOCTYPE nel documento prima dell’elemento radice. Il valore predefinito è`falso`. Quando si salva in EPUB o HTML5 (Html5 ) la dichiarazione DOCTYPE viene sempre scritta.
FontResourcesSubsettingSizeThreshold { get; set; }	Controlla quali risorse di font necessitano di sottoinsiemi quando si salva in HTML, MHTML o EPUB. L’impostazione predefinita è`0` .
FontSavingCallback { get; set; }	Consente di controllare come vengono salvati i font quando un documento viene salvato in HTML, MHTML o EPUB.
FontsFolder { get; set; }	Specifica la cartella fisica in cui vengono salvati i font quando si esporta un documento in HTML. Il valore predefinito è una stringa vuota.
FontsFolderAlias { get; set; }	Specifica il nome della cartella utilizzata per costruire gli URI dei font scritti in un documento HTML. Il valore predefinito è una stringa vuota.
HtmlVersion { get; set; }	Specifica la versione dello standard HTML che deve essere utilizzata quando si salva il documento in HTML o MHTML. Il valore predefinito èXhtml .
ImageResolution { get; set; }	Specifica la risoluzione di output per le immagini durante l’esportazione in HTML, MHTML o EPUB. Il valore predefinito è`96 dpi` .
ImageSavingCallback { get; set; }	Consente di controllare come vengono salvate le immagini quando un documento viene salvato in formato HTML, MHTML o EPUB.
ImagesFolder { get; set; }	Specifica la cartella fisica in cui vengono salvate le immagini durante l’esportazione di un documento in formato HTML. Il valore predefinito è una stringa vuota.
ImagesFolderAlias { get; set; }	Specifica il nome della cartella utilizzata per costruire gli URI delle immagini scritti in un documento HTML. Il valore predefinito è una stringa vuota.
ImlRenderingMode { get; set; }	Ottiene o imposta un valore che determina come vengono renderizzati gli oggetti ink (InkML).
MemoryOptimization { get; set; }	Ottiene o imposta il valore che determina se l’ottimizzazione della memoria deve essere eseguita prima di salvare il documento. Il valore predefinito per questa proprietà è`falso` .
MetafileFormat { get; set; }	Specifica in quale formato vengono salvati i metafile durante l’esportazione in HTML, MHTML o EPUB. Il valore predefinito èPng , il che significa che i metafile vengono renderizzati in immagini PNG raster.
NavigationMapLevel { get; set; }	Specifica il livello massimo di intestazioni da inserire nella mappa di navigazione durante l’esportazione nei formati EPUB, MOBI o AZW3 . Il valore predefinito è`3` .
OfficeMathOutputMode { get; set; }	Controlla come gli oggetti OfficeMath vengono esportati in HTML, MHTML o EPUB. Il valore predefinito èImage .
PrettyFormat { get; set; }	Quando`VERO` , formatta bene l’output dove applicabile. Il valore predefinito è`falso` .
ProgressCallback { get; set; }	Viene chiamato durante il salvataggio di un documento e accetta dati sullo stato di avanzamento del salvataggio.
RemoveJavaScriptFromLinks { get; set; }	Specifica se JavaScript verrà rimosso dai collegamenti. Il valore predefinito è`falso` .
ReplaceBackslashWithYenSign { get; set; }	Specifica se i caratteri barra rovesciata devono essere sostituiti con il segno yen. Il valore predefinito è`falso` .
ResolveFontNames { get; set; }	Specifica se i nomi delle famiglie di font utilizzati nel documento vengono risolti e sostituiti in base a `FontSettings` quando vengono scritti in formati basati su HTML.
ResourceFolder { get; set; }	Specifica una cartella fisica in cui vengono salvate tutte le risorse come immagini, font e CSS esterni quando un documento viene esportato in HTML. Il valore predefinito è una stringa vuota.
ResourceFolderAlias { get; set; }	Specifica il nome della cartella utilizzata per costruire gli URI di tutte le risorse scritte in un documento HTML. Il valore predefinito è una stringa vuota.
override SaveFormat { get; set; }	Specifica il formato in cui il documento verrà salvato se viene utilizzato questo oggetto di opzioni di salvataggio. Può essereHtml ,Mhtml ,Epub , Azw3 OMobi .
ScaleImageToShapeSize { get; set; }	Specifica se le immagini vengono ridimensionate da Aspose.Words in base alle dimensioni della forma di delimitazione durante l’esportazione in HTML, MHTML o EPUB. Il valore predefinito è`VERO` .
TableWidthOutputMode { get; set; }	Controlla come le larghezze di tabelle, righe e celle vengono esportate in HTML, MHTML o EPUB. Il valore predefinito èAll .
TempFolder { get; set; }	Specifica la cartella per i file temporanei utilizzati durante il salvataggio in un file DOC o DOCX. Per impostazione predefinita, questa proprietà è`null` e non vengono utilizzati file temporanei.
UpdateAmbiguousTextFont { get; set; }	Determina se gli attributi del font verranno modificati in base al codice carattere utilizzato.
UpdateCreatedTimeProperty { get; set; }	Ottiene o imposta un valore che determina se il`CreatedTime` la proprietà viene aggiornata prima del salvataggio. Il valore predefinito è`falso` ;
UpdateFields { get; set; }	Ottiene o imposta un valore che determina se i campi di determinati tipi devono essere aggiornati prima di salvare il documento in un formato di pagina fisso. Il valore predefinito per questa proprietà è`VERO` .
UpdateLastPrintedProperty { get; set; }	Ottiene o imposta un valore che determina se il`LastPrinted` la proprietà viene aggiornata prima del salvataggio.
UpdateLastSavedTimeProperty { get; set; }	Ottiene o imposta un valore che determina se il`LastSavedTime` la proprietà viene aggiornata prima del salvataggio.
UseAntiAliasing { get; set; }	Ottiene o imposta un valore che determina se utilizzare o meno l’anti-aliasing per il rendering.
UseHighQualityRendering { get; set; }	Ottiene o imposta un valore che determina se utilizzare o meno algoritmi di rendering di alta qualità (ad esempio lenti).

Esempi

Mostra come specificare la cartella in cui archiviare le immagini collegate dopo averle salvate in formato .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);

// Imposta un'opzione per esportare i campi del modulo come testo normale anziché come elementi di input HTML.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Html)
{
    ExportTextInputFormFieldAsText = true, 
    ImagesFolder = imagesDir
};

doc.Save(ArtifactsDir + "HtmlSaveOptions.SaveHtmlWithOptions.html", options);

Mostra come utilizzare una codifica specifica quando si salva un documento in formato .epub.

Document doc = new Document(MyDir + "Rendering.docx");

// Utilizzare un oggetto SaveOptions per specificare la codifica per un documento che salveremo.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.SaveFormat = SaveFormat.Epub;
saveOptions.Encoding = Encoding.UTF8;

// Per impostazione predefinita, un documento .epub di output avrà tutto il suo contenuto in una parte HTML.
// Un criterio di suddivisione consente di segmentare il documento in più parti HTML.
// Imposteremo i criteri per suddividere il documento in paragrafi di intestazione.
// Questa funzione è utile per i lettori che non riescono a leggere file HTML di dimensioni superiori a una determinata soglia.
saveOptions.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;

// Specificare che si desidera esportare le proprietà del documento.
saveOptions.ExportDocumentProperties = true;

doc.Save(ArtifactsDir + "HtmlSaveOptions.Doc2EpubSaveOptions.epub", saveOptions);

Mostra come dividere un documento in parti e salvarle.

public void DocumentPartsFileNames()
{
    Document doc = new Document(MyDir + "Rendering.docx");
    string outFileName = "SavingCallback.DocumentPartsFileNames.html";

    // Creiamo un oggetto "HtmlFixedSaveOptions", che possiamo passare al metodo "Save" del documento
    // per modificare il modo in cui convertiamo il documento in HTML.
    HtmlSaveOptions options = new HtmlSaveOptions();

    // Se salviamo il documento normalmente, ci sarà un output HTML
    // documento con tutto il contenuto del documento sorgente.
    // Imposta la proprietà "DocumentSplitCriteria" su "DocumentSplitCriteria.SectionBreak" per
    // salviamo il nostro documento in più file HTML: uno per ogni sezione.
    options.DocumentSplitCriteria = DocumentSplitCriteria.SectionBreak;

    // Assegna un callback personalizzato alla proprietà "DocumentPartSavingCallback" per modificare la logica di salvataggio delle parti del documento.
    options.DocumentPartSavingCallback = new SavedDocumentPartRename(outFileName, options.DocumentSplitCriteria);

    // Se convertiamo in HTML un documento contenente immagini, otterremo un file HTML contenente collegamenti a più immagini.
    // Ogni immagine sarà sotto forma di file nel file system locale.
    // Esiste anche una callback che può personalizzare il nome e la posizione del file system di ciascuna immagine.
    options.ImageSavingCallback = new SavedImageRename(outFileName);

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

/// <summary>
/// Imposta nomi di file personalizzati per i documenti di output in cui l'operazione di salvataggio suddivide un documento.
/// </summary>
private class SavedDocumentPartRename : IDocumentPartSavingCallback
{
    public SavedDocumentPartRename(string outFileName, DocumentSplitCriteria documentSplitCriteria)
    {
        mOutFileName = outFileName;
        mDocumentSplitCriteria = documentSplitCriteria;
    }

    void IDocumentPartSavingCallback.DocumentPartSaving(DocumentPartSavingArgs args)
    {
        // Possiamo accedere all'intero documento sorgente tramite la proprietà "Documento".
        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)}";

        // Di seguito sono riportati due modi per specificare dove Aspose.Words salverà ciascuna parte del documento.
        // 1 - Imposta un nome file per il file di output:
        args.DocumentPartFileName = partFileName;

        // 2 - Crea un flusso personalizzato per il file di output:
        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>
/// Imposta nomi di file personalizzati per i file immagine creati da una conversione HTML.
/// </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)}";

        // Di seguito sono riportati due modi per specificare dove Aspose.Words salverà ciascuna parte del documento.
        // 1 - Imposta un nome file per il file immagine di output:
        args.ImageFileName = imageFileName;

        // 2 - Crea un flusso personalizzato per il file immagine di output:
        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;
}

Guarda anche

class SaveOptions
spazio dei nomi Aspose.Words.Saving
assemblea Aspose.Words

HtmlOfficeMathOutputMode Enum HtmlVersion Enum