HtmlFixedSaveOptions

HtmlFixedSaveOptions class

Kann verwendet werden, um zusätzliche Optionen beim Speichern eines Dokuments imHtmlFixed format.

Um mehr zu erfahren, besuchen Sie dieSpeicheroptionen festlegen Dokumentationsartikel.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Konstrukteure

Name	Beschreibung
HtmlFixedSaveOptions()	Default_Constructor

Eigenschaften

Name	Beschreibung
AllowEmbeddingPostScriptFonts { get; set; }	Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob das Einbetten von Schriftarten mit PostScript-Konturen beim Einbetten von TrueType-Schriftarten in ein Dokument beim Speichern zulässig ist. 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`"oh"` .
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 ab oder legt ihn fest (einschließlich Dateiname). Der Standardwert für diese Eigenschaft istleere Zeichenfolge (Empty ).
Dml3DEffectsRenderingMode { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie 3D-Effekte gerendert werden.
virtual DmlEffectsRenderingMode { get; set; }	Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie DrawingML-Effekte gerendert werden.
DmlRenderingMode { get; set; }	Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie DrawingML-Formen gerendert werden.
Encoding { get; set; }	Gibt die Kodierung an, die beim Exportieren nach HTML verwendet werden soll. Der Standardwert ist`neue UTF8-Kodierung (true)` (UTF-8 mit BOM).
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 im Base64-Format in HTML-Dokumente eingebettet werden sollen. Beachten Sie, dass das Setzen dieses Flags die Größe der HTML-Ausgabedatei erheblich erhöhen kann.
ExportEmbeddedImages { get; set; }	Gibt an, ob Bilder in HTML-Dokumente im Base64-Format eingebettet werden sollen. Beachten Sie, dass das Setzen dieses Flags die Größe der HTML-Ausgabedatei erheblich erhöhen kann.
ExportEmbeddedSvg { get; set; }	Gibt an, ob SVG-Ressourcen in HTML-Dokumente eingebettet werden sollen. Der Standardwert ist`WAHR` .
ExportFormFields { get; set; }	Ruft ab oder legt fest, ob Formularfelder als interaktive Elemente (als „Eingabe“-Tag) exportiert und nicht in Text oder Grafiken konvertiert werden.
ExportGeneratorName { get; set; }	Wann`WAHR` , bewirkt, dass der Name und die Version von Aspose.Words in die erstellten Dateien eingebettet werden. Der Standardwert ist`WAHR` .
FontFormat { get; set; }	Ruft ab oder legt fest`ExportFontFormat` Wird für den Schriftartenexport verwendet. Der Standardwert istWoff .
IdPrefix { get; set; }	Gibt ein Präfix an, das allen generierten Element-IDs im Ausgabedokument vorangestellt wird. Der Standardwert ist null und es wird kein Präfix vorangestellt.
ImlRenderingMode { get; set; }	Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie InkML-Objekte gerendert werden.
JpegQuality { get; set; }	Ruft einen Wert ab oder legt ihn fest, der die Qualität der JPEG-Bilder im HTML-Dokument bestimmt.
MemoryOptimization { get; set; }	Ruft einen Wert ab oder legt ihn 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 Optionen für das Rendern von Metadateien.
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 der gleichen Formatierung werden verkettet. Hinweis: Die Genauigkeit der Inhaltsanzeige kann beeinträchtigt werden, wenn diese Eigenschaft auf`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 sie fest. Standardmäßig sind alle Seiten im Dokument dargestellt.
PrettyFormat { get; set; }	Wann`WAHR` , formatiert die Ausgabe, wo anwendbar. Der Standardwert ist`FALSCH` .
ProgressCallback { get; set; }	Wird beim Speichern eines Dokuments aufgerufen und akzeptiert Daten zum Speicherfortschritt.
RemoveJavaScriptFromLinks { get; set; }	Gibt an, ob JavaScript aus Links entfernt wird. Standard ist`FALSCH` .
ResourceSavingCallback { get; set; }	Ermöglicht die Steuerung, wie Ressourcen (Bilder, Schriftarten und CSS) gespeichert werden, wenn ein Dokument in das HTML-Format mit festen Seiten exportiert wird.
ResourcesFolder { get; set; }	Gibt den physischen Ordner an, in dem Ressourcen (Bilder, Schriftarten, CSS) beim Exportieren eines Dokuments in das HTML-Format gespeichert werden. 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 eine separate Datei “fontFaces.css” gespeichert werden sollen, wenn ein Dokument mit externem Stylesheet gespeichert wird (d.h. wenn`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 nurHtmlFixed .
ShowPageBorder { get; set; }	Gibt an, ob ein Rahmen um die Seiten angezeigt werden soll. Standard ist`WAHR` .
TempFolder { get; set; }	Gibt den Ordner für temporäre Dateien an, der beim Speichern in eine DOC- oder DOCX-Datei verwendet wird. Standardmäßig ist diese Eigenschaft`null` und es werden keine temporären Dateien verwendet.
UpdateAmbiguousTextFont { get; set; }	Bestimmt, ob die Schriftattribute entsprechend dem verwendeten Zeichencode geändert werden.
UpdateCreatedTimeProperty { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob die`CreatedTime` Eigenschaft wird vor dem Speichern aktualisiert. Der Standardwert ist`FALSCH` ;
UpdateFields { get; set; }	Ruft einen Wert ab oder legt einen Wert 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 einen Wert fest, der bestimmt, ob Anti-Aliasing zum Rendern verwendet werden soll oder nicht.
UseHighQualityRendering { get; set; }	Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob qualitativ hochwertige (d. h. langsame) Rendering-Algorithmen verwendet werden sollen oder nicht.
UseTargetMachineFonts { get; set; }	Flag gibt an, ob Schriftarten vom Zielcomputer zur Anzeige des Dokuments verwendet werden müssen. Wenn dieses Flag auf`WAHR` ,`FontFormat` Und`ExportEmbeddedFonts` Eigenschaften haben keine Wirkung, auch`ResourceSavingCallback` wird nicht für Schriftarten 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 ein Rückruf verwendet wird, 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 vorhanden ist, 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 der enthaltenen Ressourcen, wenn 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