LoadOptions

LoadOptions class

Ermöglicht die Angabe zusätzlicher Optionen (z. B. Passwort oder Basis-URI), wenn ein Dokument in ein geladen wirdDocument Objekt.

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

public class LoadOptions

Konstrukteure

NameBeschreibung
LoadOptions()Initialisiert eine neue Instanz dieser Klasse mit Standardwerten.
LoadOptions(string)Eine Verknüpfung zum Initialisieren einer neuen Instanz dieser Klasse mit dem angegebenen Kennwort, um ein verschlüsseltes Dokument zu laden.
LoadOptions(LoadFormat, string, string)Eine Verknüpfung zum Initialisieren einer neuen Instanz dieser Klasse mit Eigenschaften, die auf die angegebenen Werte festgelegt sind.

Eigenschaften

NameBeschreibung
BaseUri { get; set; }Ruft die Zeichenfolge ab oder legt diese fest, die bei Bedarf zum Auflösen relativer URIs im Dokument in absolute URIs verwendet wird. Kann seinNull oder leere Zeichenfolge. Standard istNull .
ConvertMetafilesToPng { get; set; }Ruft ab oder legt fest, ob die 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, die zum Laden eines HTML-, TXT- oder CHM-Dokuments verwendet wird, oder legt diese fest, wenn die Kodierung im Dokument nicht angegeben ist . Kann seinNull . Standard istNull .
FontSettings { get; set; }Ermöglicht das Festlegen von Schriftarteinstellungen für Dokumente.
IgnoreOleData { get; set; }Gibt an, ob die OLE-Daten ignoriert werden sollen.
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 Dokumentladevorgang 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 seinNull oder leere Zeichenfolge. Standard istNull .
PreserveIncludePictureField { get; set; }Ruft ab oder legt fest, ob das INCLUDEPICTURE-Feld beim Lesen von Microsoft Word-Formaten beibehalten werden soll. Der Standardwert istFALSCH .
ProgressCallback { get; set; }Wird während des Ladens eines Dokuments aufgerufen und akzeptiert Daten über den Ladefortschritt.
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 von Dokumenten. 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 attribute.
WarningCallback { get; set; }Wird während eines Ladevorgangs aufgerufen, wenn ein Problem erkannt wird, das zu einem Verlust der Daten- oder Formatierungstreue führen könnte.

Methoden

NameBeschreibung
override Equals(object)

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 anhand des Dateinamens aus dem lokalen Dateisystem:
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