HtmlFixedSaveOptions

HtmlFixedSaveOptions class

Kann zum Angeben zusätzlicher Optionen beim Speichern eines Dokuments im verwendet werdenHtmlFixed format.

Um mehr zu erfahren, besuchen Sie dieGeben Sie Speicheroptionen an Dokumentationsartikel.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Konstrukteure

Name	Beschreibung
HtmlFixedSaveOptions()	Default_Constructor

Eigenschaften

Name	Beschreibung
AllowEmbeddingPostScriptFonts { get; set; }	Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob das Einbetten von Schriftarten mit PostScript-Umrissen zulässig ist , wenn TrueType-Schriftarten in ein Dokument eingebettet werden, sobald es gespeichert wird. Der Standardwert ist`FALSCH` .
ColorMode { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie Farben gerendert werden.
CssClassNamesPrefix { get; set; }	Gibt das Präfix an, das allen Klassennamen in der Datei „style.css“ hinzugefügt wird. Der Standardwert ist`„aw“` .
CustomTimeZoneInfo { get; set; }	Ruft die benutzerdefinierte lokale Zeitzone ab, die für Datums-/Uhrzeitfelder verwendet wird, oder legt diese fest.
DefaultTemplate { get; set; }	Ruft den Pfad zur Standardvorlage (einschließlich Dateiname) ab oder legt diesen fest. Der Standardwert für diese Eigenschaft istleerer String (Empty).
Dml3DEffectsRenderingMode { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie 3D-Effekte gerendert werden.
virtual DmlEffectsRenderingMode { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie DrawingML-Effekte gerendert werden.
DmlRenderingMode { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie DrawingML-Formen gerendert werden.
Encoding { get; set; }	Gibt die beim Exportieren nach HTML zu verwendende Codierung an. Der Standardwert ist`neue UTF8Encoding(true)` (UTF-8 mit Stückliste).
ExportEmbeddedCss { get; set; }	Gibt an, ob das CSS (Cascading Style Sheet) in das HTML-Dokument eingebettet werden soll.
ExportEmbeddedFonts { get; set; }	Gibt an, ob Schriftarten in ein HTML-Dokument im Base64-Format eingebettet werden sollen. Hinweis: Das Setzen dieses Flags kann die Größe der ausgegebenen HTML-Datei erheblich erhöhen.
ExportEmbeddedImages { get; set; }	Gibt an, ob Bilder in ein HTML-Dokument im Base64-Format eingebettet werden sollen. Hinweis: Das Setzen dieses Flags kann die Größe der ausgegebenen HTML-Datei erheblich erhöhen.
ExportEmbeddedSvg { get; set; }	Gibt an, ob SVG-Ressourcen in ein HTML-Dokument eingebettet werden sollen. Der Standardwert ist`WAHR` .
ExportFormFields { get; set; }	Ruft die Angabe ab, ob Formularfelder als interaktive Elemente (als „Eingabe“-Tag) exportiert und nicht in Text oder Grafiken konvertiert werden, oder legt diese fest.
ExportGeneratorName { get; set; }	Wann`WAHR` , bewirkt, dass der Name und die Version von Aspose.Words in erzeugte Dateien eingebettet werden. Der Standardwert ist`WAHR` .
FontFormat { get; set; }	Ruft ab oder legt fest`ExportFontFormat` Wird zum Exportieren von Schriftarten verwendet. Der Standardwert istWoff .
ImlRenderingMode { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie Ink-Objekte (InkML) gerendert werden.
JpegQuality { get; set; }	Ruft einen Wert ab oder legt diesen fest, der die Qualität der JPEG-Bilder im HTML-Dokument bestimmt.
MemoryOptimization { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob vor dem Speichern des Dokuments eine Speicheroptimierung durchgeführt werden soll. Der Standardwert für diese Eigenschaft ist`FALSCH` .
MetafileRenderingOptions { get; set; }	Ermöglicht die Angabe von Metadatei-Rendering-Optionen.
NumeralFormat { get; set; }	Ruft ab oder legt fest`NumeralFormat` Wird zur Darstellung von Ziffern verwendet. Standardmäßig werden europäische Ziffern verwendet.
override OptimizeOutput { get; set; }	Flag gibt an, ob es zur Optimierung der Ausgabe erforderlich ist. Wenn dieses Flag gesetzt ist, werden redundante verschachtelte Leinwände und leere Leinwände entfernt, auch benachbarte Glyphen mit derselben Formatierung werden verkettet. Hinweis: Die Genauigkeit der Inhaltsanzeige kann beeinträchtigt werden, wenn Diese Eigenschaft ist auf festgelegt`WAHR` . Standard ist`WAHR` .
PageHorizontalAlignment { get; set; }	Gibt die horizontale Ausrichtung von Seiten in einem HTML-Dokument an. Der Standardwert istCenter .
PageMargins { get; set; }	Gibt die Ränder um Seiten in einem HTML-Dokument an. Der Randwert wird in Punkten gemessen und sollte gleich oder größer als 0 sein. Der Standardwert ist 10 Punkte.
PageSavingCallback { get; set; }	Ermöglicht die Steuerung, wie einzelne Seiten gespeichert werden, wenn ein Dokument in ein festes Seitenformat exportiert wird.
PageSet { get; set; }	Ruft die zu rendernden Seiten ab oder legt diese fest. Standard sind alle Seiten im Dokument.
PrettyFormat { get; set; }	Wann`WAHR` hübsche Ausgabeformate, sofern zutreffend. Der Standardwert ist`FALSCH` .
ProgressCallback { get; set; }	Wird beim Speichern eines Dokuments aufgerufen und akzeptiert Daten über den Speicherfortschritt.
ResourceSavingCallback { get; set; }	Ermöglicht die Steuerung, wie Ressourcen (Bilder, Schriftarten und CSS) gespeichert werden, wenn ein Dokument in das HTML-Format mit fester Seite exportiert wird.
ResourcesFolder { get; set; }	Gibt den physischen Ordner an, in dem Ressourcen (Bilder, Schriftarten, CSS) gespeichert werden, wenn ein Dokument in das HTML-Format exportiert wird. Standard ist`Null` .
ResourcesFolderAlias { get; set; }	Gibt den Namen des Ordners an, der zum Erstellen von Bild-URIs verwendet wird, die in ein HTML-Dokument geschrieben werden. Der Standardwert ist`Null` .
SaveFontFaceCssSeparately { get; set; }	Flag gibt an, ob „@font-face“-CSS-Regeln in einer separaten Datei „fontFaces.css“ abgelegt werden sollen , wenn ein Dokument mit einem externen Stylesheet gespeichert wird (d. h. wann`ExportEmbeddedCss` ist`FALSCH` ). Der Standardwert ist`FALSCH` , alle CSS-Regeln werden in eine einzelne Datei „styles.css“ geschrieben.
override SaveFormat { get; set; }	Gibt das Format an, in dem das Dokument gespeichert wird, wenn dieses Speicheroptionsobjekt verwendet wird. Kann nur seinHtmlFixed .
ShowPageBorder { get; set; }	Gibt an, ob der Rand um Seiten herum angezeigt werden soll. Die Standardeinstellung ist`WAHR` .
TempFolder { get; set; }	Gibt den Ordner für temporäre Dateien an, die beim Speichern in einer DOC- oder DOCX-Datei verwendet werden. Standardmäßig ist diese Eigenschaft`Null` und es werden keine temporären Dateien verwendet.
UpdateCreatedTimeProperty { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob die`CreatedTime` Die Eigenschaft wird vor dem Speichern aktualisiert. Der Standardwert ist`FALSCH` ;
UpdateFields { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Felder bestimmter Typen aktualisiert werden sollen, bevor das Dokument in einem festen Seitenformat gespeichert wird. Der Standardwert für diese Eigenschaft ist`WAHR` .
UpdateLastPrintedProperty { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob die`LastPrinted` Eigenschaft wird vor dem Speichern aktualisiert.
UpdateLastSavedTimeProperty { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob die`LastSavedTime` Eigenschaft wird vor dem Speichern aktualisiert.
UseAntiAliasing { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Anti-Aliasing für das Rendering verwendet werden soll oder nicht.
UseHighQualityRendering { get; set; }	Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob hochwertige (d. h. langsame) Rendering-Algorithmen verwendet werden sollen oder nicht.
UseTargetMachineFonts { get; set; }	Flag gibt an, ob Schriftarten vom Zielcomputer zum Anzeigen des Dokuments verwendet werden müssen. Wenn dieses Flag auf gesetzt ist`WAHR` ,`FontFormat` Und`ExportEmbeddedFonts` Eigenschaften haben auch keine Auswirkung, `ResourceSavingCallback` wird für Schriftarten nicht ausgelöst. Standard ist`FALSCH` .

Methoden

Name	Beschreibung
override Equals(object)	Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat.

Beispiele

Zeigt, wie Sie einen Rückruf verwenden, um die URIs externer Ressourcen zu drucken, die beim Konvertieren eines Dokuments in HTML erstellt wurden.

public void HtmlFixedResourceFolder()
{
    Document doc = new Document(MyDir + "Rendering.docx");

    ResourceUriPrinter callback = new ResourceUriPrinter();

    HtmlFixedSaveOptions options = new HtmlFixedSaveOptions
    {
        SaveFormat = SaveFormat.HtmlFixed,
        ExportEmbeddedImages = false,
        ResourcesFolder = ArtifactsDir + "HtmlFixedResourceFolder",
        ResourcesFolderAlias = ArtifactsDir + "HtmlFixedResourceFolderAlias",
        ShowPageBorder = false,
        ResourceSavingCallback = callback
    };

    // Ein durch ResourcesFolderAlias angegebener Ordner enthält die Ressourcen anstelle von ResourcesFolder.
    // Wir müssen sicherstellen, dass der Ordner existiert, bevor die Streams ihre Ressourcen darin ablegen können.
    Directory.CreateDirectory(options.ResourcesFolderAlias);

    doc.Save(ArtifactsDir + "HtmlFixedSaveOptions.HtmlFixedResourceFolder.html", options);

    Console.WriteLine(callback.GetText());

    string[] resourceFiles = Directory.GetFiles(ArtifactsDir + "HtmlFixedResourceFolderAlias");

    Assert.False(Directory.Exists(ArtifactsDir + "HtmlFixedResourceFolder"));
    Assert.AreEqual(6, resourceFiles.Count(f => f.EndsWith(".jpeg") || f.EndsWith(".png") || f.EndsWith(".css")));
}

/// <summary>
/// Zählt und druckt URIs von Ressourcen, die in enthalten sind, während sie in festes HTML konvertiert werden.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // Wenn wir im SaveOptions-Objekt einen Ordneralias festlegen, können wir ihn von hier aus drucken.
        mText.AppendLine($"Resource #{++mSavedResourceCount} \"{args.ResourceFileName}\"");

        string extension = Path.GetExtension(args.ResourceFileName);
        switch (extension)
        {
            case ".ttf":
            case ".woff":
            {
                // Standardmäßig verwendet „ResourceFileUri“ den Systemordner für Schriftarten.
                // Um Probleme auf anderen Plattformen zu vermeiden, müssen Sie den Pfad für die Schriftarten explizit angeben.
                args.ResourceFileUri = ArtifactsDir + Path.DirectorySeparatorChar + args.ResourceFileName;
                break;
            }
        }

        mText.AppendLine("\t" + args.ResourceFileUri);

        // Wenn wir in der Eigenschaft „ResourcesFolderAlias“ einen Ordner angegeben haben,
        // Wir müssen auch jeden Stream umleiten, um seine Ressource in diesem Ordner abzulegen.
        args.ResourceStream = new FileStream(args.ResourceFileUri, FileMode.Create);
        args.KeepResourceStreamOpen = false;
    }

    public string GetText()
    {
        return mText.ToString();
    }

    private int mSavedResourceCount;
    private readonly StringBuilder mText = new StringBuilder();
}

Siehe auch

HtmlFixedPageHorizontalAlignment Enum HtmlMetafileFormat Enum