LoadOptions

LoadOptions class

Ermöglicht die Angabe zusätzlicher Optionen (z. B. Kennwort oder Basis-URI) beim Laden eines Dokuments in einenDocument Objekt.

public class LoadOptions

Konstrukteure

Name Beschreibung
LoadOptions() Initialisiert eine neue Instanz dieser Klasse mit Standardwerten.
LoadOptions(string) Eine Verknüpfung zum Initialisieren einer neuen Instanz dieser Klasse mit dem angegebenen Passwort zum Laden eines verschlüsselten Dokuments.
LoadOptions(LoadFormat, string, string) Eine Verknüpfung zum Initialisieren einer neuen Instanz dieser Klasse mit auf die angegebenen Werte gesetzten Eigenschaften.

Eigenschaften

Name Beschreibung
BaseUri { get; set; } Ruft die Zeichenfolge ab oder legt sie fest, die verwendet wird, um im Dokument gefundene relative URIs bei Bedarf in absolute URIs aufzulösen. Kann null oder eine leere Zeichenfolge sein. Standard ist null.
ConvertMetafilesToPng { get; set; } Ruft ab oder legt fest, ob Metadatei konvertiert werden soll (Wmf oderEmf ) Bilder zuPng Bildformat.
ConvertShapeToOfficeMath { get; set; } Ruft ab oder legt fest, ob Formen mit EquationXML in Office Math-Objekte konvertiert werden sollen.
Encoding { get; set; } Ruft die Kodierung ab oder legt sie fest, die verwendet wird, um ein HTML-, TXT- oder CHM-Dokument zu laden, wenn die Kodierung nicht innerhalb des Dokuments angegeben ist. Kann null sein. Standard ist null.
FlatOpcXmlMappingOnly { get; set; } Erhält oder setzt einen Wert, der festlegt, welche Dokumentformate abgebildet werden dürfenXmlMapping . Nur standardmäßigFlatOpc Dokumentformat darf gemappt werden.
FontSettings { get; set; } Ermöglicht das Festlegen von Schrifteinstellungen für Dokumente.
LanguagePreferences { get; } Ruft Spracheinstellungen ab, die beim Laden des Dokuments verwendet werden.
LoadFormat { get; set; } Gibt das Format des zu ladenden Dokuments an. Standard istAuto .
MswVersion { get; set; } Ermöglicht die Angabe, dass der Dokumentladeprozess mit einer bestimmten MS Word-Version übereinstimmen soll. Der Standardwert istWord2019
Password { get; set; } Ruft das Passwort zum Öffnen eines verschlüsselten Dokuments ab oder legt es fest. Kann null oder eine leere Zeichenfolge sein. Standard ist null.
PreserveIncludePictureField { get; set; } Ruft ab oder legt fest, ob das INCLUDEPICTURE-Feld beim Lesen von Microsoft Word-Formaten beibehalten werden soll. Der Standardwert ist „false“.
ProgressCallback { get; set; } Wird beim Laden eines Dokuments aufgerufen und nimmt Daten zum Ladefortschritt entgegen.
ResourceLoadingCallback { get; set; } Ermöglicht die Steuerung, wie externe Ressourcen (Bilder, Stylesheets) geladen werden, wenn ein Dokument aus HTML, MHTML importiert wird.
TempFolder { get; set; } Ermöglicht die Verwendung temporärer Dateien beim Lesen des Dokuments. Standardmäßig ist diese EigenschaftNull und es werden keine temporären Dateien verwendet.
UpdateDirtyFields { get; set; } Gibt an, ob die Felder mit aktualisiert werden sollenschmutzig Attribut.
WarningCallback { get; set; } Wird während eines Ladevorgangs aufgerufen, wenn ein Problem erkannt wird, das zu einem Verlust der Daten oder der Formatierung führen kann.

Beispiele

Zeigt, wie ein verschlüsseltes Microsoft Word-Dokument geladen wird.

Document doc;

// Aspose.Words löst eine Ausnahme aus, wenn wir versuchen, ein verschlüsseltes Dokument ohne sein Passwort zu öffnen.
Assert.Throws<IncorrectPasswordException>(() => doc = new Document(MyDir + "Encrypted.docx"));

// Beim Laden eines solchen Dokuments wird das Passwort mithilfe eines LoadOptions-Objekts an den Konstruktor des Dokuments übergeben.
LoadOptions options = new LoadOptions("docPassword");

// Es gibt zwei Möglichkeiten, ein verschlüsseltes Dokument mit einem LoadOptions-Objekt zu laden.
// 1 - Laden Sie das Dokument aus dem lokalen Dateisystem nach Dateiname:
doc = new Document(MyDir + "Encrypted.docx", options);
// 2 - Laden Sie das Dokument aus einem Stream:
using (Stream stream = File.OpenRead(MyDir + "Encrypted.docx"))
{
    doc = new Document(stream, options);

Siehe auch